<!DOCTYPE html><html><head><title></title><style type="text/css">p.MsoNormal,p.MsoNoSpacing{margin:0}</style></head><body><div style="font-family:"Times New Roman", times, serif;">mkdocs isn't bad, mdbook from the rust community is pretty great and has some good plugins/options. Both of them can work with Github Actions to publish to a variety of places like s3 buckets or github pages if you want things to be accessible. <br></div><div style="font-family:"Times New Roman", times, serif;"><br></div><div style="font-family:"Times New Roman", times, serif;">There's also hugo and zola for static site generation but they're less focused on docs and more generic.<br></div><div style="font-family:"Times New Roman", times, serif;"><br></div><div style="font-family:"Times New Roman", times, serif;">On 2023-12-12 10:01 Luke Thompson wrote:<br></div><blockquote type="cite" id="qt" style=""><p>G'day folks,<br></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.<br></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.<br></p><p><br></p><div><a class="qt-moz-txt-link-freetext" href="https://github.com/squidfunk/mkdocs-material">https://github.com/squidfunk/mkdocs-material</a><br></div><div> Base of: <a class="qt-moz-txt-link-freetext" href="https://www.mkdocs.org/">https://www.mkdocs.org/</a><br></div><p><br></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).<br></p><p>Does anyone have experiences, check this, avoid that, sort of
feedback that they're happy to share? We'd be incredibly grateful!<br></p><p>A couple of others from my GitHub starred list:<br></p><p><br></p><div><a class="qt-moz-txt-link-freetext" href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a><br></div><div> <a class="qt-moz-txt-link-freetext" href="https://github.com/BookStackApp/BookStack">https://github.com/BookStackApp/BookStack</a><br></div><p><br></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.<br></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="qt-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><br></p><p><br></p><div>Cheers,<br></div><div> Luke<br></div><p><br></p><div>_______________________________________________<br></div><div>AusNOG mailing list<br></div><div><a href="mailto:AusNOG@lists.ausnog.net">AusNOG@lists.ausnog.net</a><br></div><div><a href="https://lists.ausnog.net/mailman/listinfo/ausnog">https://lists.ausnog.net/mailman/listinfo/ausnog</a><br></div><div><br></div></blockquote><div style="font-family:"Times New Roman", times, serif;"><br></div></body></html>