|
| 1 | +<!DOCTYPE html> |
| 2 | +<html><head> |
| 3 | + <meta lang="en" charset="UTF-8"/> |
| 4 | + <meta name="viewport" content="width=device-width, initial-scale=1"/> |
| 5 | + <link rel="icon" type="image/x-icon" href="/images/osc-logo.png"> |
| 6 | + <link rel="stylesheet" href="/css/main.css"/> |
| 7 | + <title>OpenSourceCorp</title> |
| 8 | +</head> |
| 9 | +<body><div class="sidenav"> |
| 10 | + <a href="/"> |
| 11 | + <img src="/images/osc-logo.png" style="width:120px;height:100px;" alt="OSC Logo"/> |
| 12 | + </a> |
| 13 | + <h3>Navigation</h3> |
| 14 | + <ul> |
| 15 | + <li><a href="/index.html">Home</a></li> |
| 16 | + <li><a href="/blog/index.html">Blog</a></li> |
| 17 | + |
| 18 | + <li><a href="https://github.com/opensourcecorp">OSC Source Code</a></li> |
| 19 | + </ul> |
| 20 | +</div> |
| 21 | +<div id="content" class="content"> |
| 22 | + |
| 23 | + <h2>Progress Report 2022-06-05</h2><em>By Ryan J. Price @ 2022-06-05 21:20:16 -0500 CDT; reading time 3m</em><br/><br/><br/> |
| 24 | + |
| 25 | + <p>Not too long between updates this time, but I’ve got a few neat pieces of news |
| 26 | +to share.</p> |
| 27 | +<ul> |
| 28 | +<li> |
| 29 | +<p>First and foremost, you may recall that I said we’d gotten a domain name |
| 30 | +(<code>opensourcecorp.org</code>) in a previous post. For some time now, it’s really just |
| 31 | +had some redirect rules to point folks to the GitHub Org, and to the GitHub |
| 32 | +Pages site for blog posts.</p> |
| 33 | +<p>But now, it’s a <em><strong><a href="https://opensourcecorp.org">real-ass website!</a></strong></em> You |
| 34 | +might even be reading this post on it right now!</p> |
| 35 | +<p>It’s still being served through GH Pages, but in a sort of nonstandard way |
| 36 | +(i.e. no longer using Jekyll natively), with the OSC domain instead of the GHP |
| 37 | +domain format. I’m also using <a href="https://gohugo.io">Hugo</a> as the static-site |
| 38 | +generator instead – but not using much of its fancy features; it’s pretty |
| 39 | +plain HTML & CSS at the end of the day. Which, is how I’d like it to be.</p> |
| 40 | +<p>The website generator repo is |
| 41 | +<a href="https://github.com/opensourcecorp/website">here</a>, and is being served from |
| 42 | +<a href="https://github.com/opensourcecorp/opensourcecorp.github.io">here</a> (just like |
| 43 | +it was before).</p> |
| 44 | +<p>I also set us up with <a href="https://github.com/opensourcecorp/website/blob/main/static/images/osc-logo.png">a sick sk8rboi |
| 45 | +logo</a>! |
| 46 | +It’s not the prettiest thing in the world (I’m not an artist by any stretch of |
| 47 | +the imagination), but I thought the “Super-S” style was a meta-nostalgic |
| 48 | +callback to how OSC is intended to be built – with accessible, |
| 49 | +eventually-familiar tooling.</p> |
| 50 | +<p>The logo is visible on the site’s navbar, as well as being its favicon on your |
| 51 | +browser tab. It was designed using a custom Shape on |
| 52 | +<a href="https://app.diagrams.net">diagrams.net</a>, and you can find the XML-y code used |
| 53 | +to create it |
| 54 | +<a href="https://github.com/opensourcecorp/website/blob/main/osc-logo.drawio.xml">here</a> |
| 55 | +(with embedded comments on how to recreate it).</p> |
| 56 | +</li> |
| 57 | +<li> |
| 58 | +<p>Next, you may recall seeing or hearing about the linter aggregator I had |
| 59 | +started as the very first OSC project: |
| 60 | +<a href="https://github.com/opensourcecorp/rhad"><code>rhadamanthus</code></a>. Its name has now |
| 61 | +been shortened to just <code>rhad</code>, and has been entirely rewritten from a |
| 62 | +collection of shell scripts (which worked fine, and that I’m still super proud |
| 63 | +of) to a Go CLI utility (which also works fine but will offer more flexibility |
| 64 | +in the future).</p> |
| 65 | +<p>I have also moved towards having <code>rhad</code> serve as much more than just a linter |
| 66 | +aggregator, but to be a holistic CI/CD solution akin to how a Jenkins shared |
| 67 | +library might work – the CI/CD subsytem will pick up your repo, and <code>rhad</code> |
| 68 | +will process it for all the relevant steps it needs to go from raw idea to |
| 69 | +production deployment. I’m really looking forward to have <code>rhad</code> continue to |
| 70 | +expand in functionality as use more cases appear across OSC.</p> |
| 71 | +</li> |
| 72 | +<li> |
| 73 | +<p>Finally, I received some helpful feedback about some of the naming conventions |
| 74 | +used within OSC projects. Before all the infra tooling was consolidated into |
| 75 | +<a href="https://github.com/opensourcecorp/osc-infra">the monorepo</a>, each infra |
| 76 | +subsystem had a “cool” name – <code>aether</code>, <code>faro</code>, <code>chonk</code>, etc. I still think |
| 77 | +they’re cool (lol), but they’re not doing anything helpful for folks looking |
| 78 | +to get involved with the project.</p> |
| 79 | +<p>These subsystems have now been renamed throughout the codebase into more |
| 80 | +meaningful names according to their actual function – e.g. <code>configmgmt</code>, |
| 81 | +<code>netsvc</code>, and <code>datastore</code>, respectively in the above example. In the longer |
| 82 | +term, this should make the infra codebase more accessible to others.</p> |
| 83 | +<p>You may still find some lingering naming conventions in other repos across the |
| 84 | +GH Org, but those will get cleaned up eventually. Let me know if you find any, |
| 85 | +or have any feedback.</p> |
| 86 | +</li> |
| 87 | +</ul> |
| 88 | +<p>The update that I think is the coolest is obviously the website, so please check |
| 89 | +it out and let me know what you think! But before you come after me too hard: |
| 90 | +yes, I know it’s “ugly” – it’s mostly intentional. But if there’s something |
| 91 | +you’d like to change, feel free to open a PR to the <a href="https://github.com/opensourcecorp/website">website |
| 92 | +repo</a> with any layout or CSS changes |
| 93 | +you have in mind! I especially could use some help finding a (non-JS) way to |
| 94 | +make the site more mobile-friendly.</p> |
| 95 | + |
| 96 | + |
| 97 | + </div></body> |
| 98 | +</html> |
0 commit comments