<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Many thanks Christian and James!</p>
<p>Agreed re: markdown, it's hard not to love MD. Plus compatibility
keeps growing.<br>
</p>
<p>I like the GitHub Pages publishing idea but as James says, only
if it's for a public space/repo/etc.</p>
<p>Appreciate the hugo/zola approach too (static site generation), I
wouldn't have considered a less specific route.</p>
<p>Will crack on with looking further into each, taking a few for a
spin, and then making a call. :-)<br>
</p>
<p>Thanks again,<br>
Luke<br>
</p>
<div class="moz-signature"><br>
</div>
<div class="moz-cite-prefix">On 12/12/2023 10:01 am, Luke Thompson
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:5d81073a-47b9-4eed-9c4e-f5c511f7858c@tncrew.com.au">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<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"
moz-do-not-send="true">https://github.com/squidfunk/mkdocs-material</a><br>
Base of: <a class="moz-txt-link-freetext"
href="https://www.mkdocs.org/" moz-do-not-send="true">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"
moz-do-not-send="true">https://github.com/facebook/docusaurus</a><br>
<a class="moz-txt-link-freetext"
href="https://github.com/BookStackApp/BookStack"
moz-do-not-send="true">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/"
moz-do-not-send="true">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>Cheers,<br>
Luke</p>
<br>
<fieldset class="moz-mime-attachment-header"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
AusNOG mailing list
<a class="moz-txt-link-abbreviated" href="mailto:AusNOG@lists.ausnog.net">AusNOG@lists.ausnog.net</a>
<a class="moz-txt-link-freetext" href="https://lists.ausnog.net/mailman/listinfo/ausnog">https://lists.ausnog.net/mailman/listinfo/ausnog</a>
</pre>
</blockquote>
</body>
</html>