|2 days ago||about 10 hours ago|
|MIT License||MIT License|
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
Common Lisp - "The Tutorial" Part 12 - Macros
1 project | reddit.com/r/lisp | 23 Mar 2022
Hello, FYI: I used https://docsify.js.org/ that turns markdown files into a static website without the need of building the site locally or in a CI. Example config. my 2c.
Ask HN: Good designs for a website that serves as a detailed FAQ?
1 project | news.ycombinator.com | 16 Feb 2022
Docsify – A magical documentation site generator
1 project | news.ycombinator.com | 22 Jan 2022
Recomendations to build a learning platform for a small company?
3 projects | reddit.com/r/learnprogramming | 11 Jan 2022
After reading your post again and this comment, I don't think Jekyll is the best choice. Something like GitBook, MkDocs, or Docsify would be a better solution as they let you control the organization and flow much better.
How to create a video editor that works in your browser.
14 projects | dev.to | 26 Nov 2021
Ask HN: What are you using for public documentation these days?
30 projects | news.ycombinator.com | 18 Nov 2021
On a new side project I'm working on I need to have a fair amount of documentation for usage, implementation, options, etc. In the past I've used https://docsify.js.org hosted on Vercel, but I was curious if there is anything else out there people like. Looking for free or paid options. So long has I can host on a subdomain I'm indifferent.
Docsify: A magical documentation site generator
1 project | news.ycombinator.com | 20 Sep 2021
Keeping Documentation Debt At Bay & Clients Happy
14 projects | dev.to | 9 Sep 2021
Docsify is a client-side only documentation generator. As a user requests a documentation page, it would fetch the associated .md file and render it all client-side. That meant that our documentation deployment process was simple again, as we could just push changes to the main branch and BOOM they would show up within seconds.
10 projects | reddit.com/r/selfhosted | 16 Jun 2021
+1 more for Docsify and its Github repo. I know this subreddit is for self-hosted things, however I wanted to add Docsify works well with Github Pages (they host, you plug in your domain or subdomain).10 projects | reddit.com/r/selfhosted | 16 Jun 2021
https://docsify.js.org/#/ SSGs are too complicated.
Stripe Open Sources Markdoc
19 projects | news.ycombinator.com | 11 May 2022
For anyone looking for a doc generation tool:
I was lately evaluating several tools like VuePress, Docusaurus and AsciiDoc.
I ended up using Mkdocs Material (https://squidfunk.github.io/mkdocs-material/). If you haven't already, have a look. I think it is pretty impressive. From tags, tabs to the fantastic built-in search ...19 projects | news.ycombinator.com | 11 May 2022
I recommend checking the list of OpenSource projects that use Material for MkDocs , for example FastAPI . Alternatively, you can clone the Material for MkDocs repository, as the docs are built with itself.
Ask HN: Is there a good framework for an interactive user manual?
3 projects | news.ycombinator.com | 28 Apr 2022
You end up with markdown split into logical folders, with a natural flow from each page to the next built in.
It’s built with python but you don’t need python knowledge at all to build; configure and serve the product.
The plug-in eco system adds the ability to embed variables into the markdown pages also you can embed html, so d3 visualisation or a vue calculator app will all embed just fine.
Really clean extensible base, insanely simple and fast to get started oh and free to use. I push mine to GitHub and have that auto build into GitHub pages or a free Netlify account.
Ask HN: Share Your Personal Site
87 projects | news.ycombinator.com | 6 Apr 2022
Next Level Readme
2 projects | reddit.com/r/opensource | 6 Apr 2022
For those that want to turn their markdown files into prettier HTML websites, there are tools like Material for MkDocs. Of course, this involves a lot more work and you’d need to host it on a separate site or enable GitHub Pages on the repo but it’s one way that I’ve found to keep the markdown files free of HTML.
New Encrypted DNS page
2 projects | reddit.com/r/PrivacyGuides | 31 Mar 2022
My favorite so far is https://squidfunk.github.io/mkdocs-material/
What devops tools should I implement from the start?
1 project | reddit.com/r/devops | 25 Mar 2022
Documentation, that should be the first thing you use. Documentation is the basis for all the things you do, it can be adapted and is implementation independent. If you want a framework to make it easy mkdocs material is nice.
Top 10 uncommon DevOps tools you should know
8 projects | dev.to | 24 Mar 2022
I love markdown, and MkDocs is my go-to tool for writing documentation, but it’s pretty bare. mkdocs-material is a template that you can put mkdocs on… except it packs a whole world of additional features: versioning your documentation, a native cookie consent solution, rich search previews, and a truckload of other things… seriously give the guy 10$ a month to get supporters-only features, and you’ll get the only documentation tool you will ever need. (for instance, the AWS Copilot CLI docs were written with this, see for yourself, that’s amazing).
mkdocs-material: Technical documentation that just works
1 project | reddit.com/r/u_TsukiZombina | 18 Mar 2022
Three DDoS attacks on my personal website
4 projects | reddit.com/r/homelab | 17 Mar 2022
What are some alternatives?
Docusaurus - Easy to maintain open source documentation websites.
sphinx - Main repository for the Sphinx documentation builder
mkdocstrings - :blue_book: Automatic documentation from sources, for MkDocs.
front-matter - Extract YAML front matter from strings
Read the Docs - The source code that powers readthedocs.org
VuePress - 📝 Minimalistic Vue-powered static site generator
mike - Manage multiple versions of your MkDocs-powered documentation via Git
BookStack - A platform to create documentation/wiki content built with PHP & Laravel
MkDocs - Project documentation with Markdown.