<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
<p>G'day folks,</p>
<p>This year's been a long road of final ground-works for us, and
I'm working to get a few more long-term nails bedded down before
it's 2024. Eliminating Atlassian from our vendor stack is one of
them. <br>
</p>
<p>We left Jira a while back for GitHub Project/Issues (not ideal,
but we're constantly refining it and do a lot on there already),
though Confluence Cloud is simple, good looking, and as of very
recently, somewhat stable (ie. less awful than it was long-term
following the re-build) and has been our Docs go-to since day 1.</p>
<p>I'd really like to shift this over to an open-source solution,
and had been looking at Mkdocs over time though it's got that
slightly rough open-source feeling to it, though brilliant, and
recently stumbled upon a nice documentation site which was powered
by Mkdocs-Material by Martin Donath & community.</p>
<p><a class="moz-txt-link-freetext" href="https://github.com/squidfunk/mkdocs-material">https://github.com/squidfunk/mkdocs-material</a><br>
Base of: <a class="moz-txt-link-freetext" href="https://www.mkdocs.org/">https://www.mkdocs.org/</a></p>
<p>Python isn't our ideal; we're primarily PHP-driven at the moment
while we keep evaluating a lower-level language to commit to
fundamentally (Rust, Python, Ruby, Perl, etc). That's a slow-burn
process for us, so at the moment Python would be a decent
compromise - though PHP is our preference for a few reasons
(namely for simplicity to internally deploy).</p>
<p>Does anyone have experiences, check this, avoid that, sort of
feedback that they're happy to share? We'd be incredibly grateful!</p>
<p>A couple of others from my GitHub starred list:</p>
<p><a class="moz-txt-link-freetext" href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a><br>
<a class="moz-txt-link-freetext" href="https://github.com/BookStackApp/BookStack">https://github.com/BookStackApp/BookStack</a></p>
<p>Feels like yesterday (10~ years ago) I was leaving uni and
joining web host #2 for $40k/year inc super... hard lessons must
be learnt - don't tell them you're happy with the pay of your
previous job! Now the kids are 6 & 2, and 2024's knocking on
the door. Wild.</p>
<p><i>(Also, quick plug for Mozilla Thunderbird - has now had a
visual redo as of v115 "Supernova" - worth a sticky beak!)<br>
<a class="moz-txt-link-freetext" href="https://blog.thunderbird.net/2023/07/our-fastest-most-beautiful-release-ever-thunderbird-115-supernova-is-here/">https://blog.thunderbird.net/2023/07/our-fastest-most-beautiful-release-ever-thunderbird-115-supernova-is-here/</a></i></p>
<p>Many thanks in advance for any recommendations, thoughts, etc.
:-)<br>
</p>
<p></p>
<p>Cheers,<br>
Luke</p>
</body>
</html>