Documentation

Top 23 Documentation Open-Source Projects

  • the-art-of-command-line

    Master the command line, in one page

    Project mention: Linux Command Line Cheat Sheet: All the Commands You Need | /r/linux | 2023-04-06

    The Art of Command Line — notes and tips on using the command-line, suitable for both beginners and experienced users

  • storybook

    Storybook is a frontend workshop for building UI components and pages in isolation. Made for UI development, testing, and documentation.

    Project mention: Documenting recommended use of basic components | /r/reactjs | 2023-06-03

    I'll be the third here to say it, but with a link: Storybook

  • Appwrite

    Appwrite - The Open Source Firebase alternative introduces iOS support . Appwrite is an open source backend server that helps you build native iOS applications much faster with realtime APIs for authentication, databases, files storage, cloud functions and much more!

  • mermaid

    Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown

    Project mention: Which tools do you use to create diagrams? | /r/golang | 2023-04-18

    MermaidJS

  • Docusaurus

    Easy to maintain open source documentation websites.

    Project mention: What are some harsh truths that r/devops needs to hear? | /r/devops | 2023-05-20

    My company uses Confluence, but if moving on there will be a greenfield project coming along. Maybe Docusaurus https://docusaurus.io/ is an ideal situation. Markdown FTW

  • tldr

    📚 Collaborative cheatsheets for console commands

    Project mention: Was looking at the GitHub page for eg and found this gem | /r/commandline | 2023-05-31
  • cheat.sh

    the only cheat sheet you need

    Project mention: ? - The only cheat sheet you need | /r/bash | 2023-06-02

    I like what you're doing with this, never used cheat.sh before but had a little look around and great idea :) I've not tested everything, i seen something about find and thought i could help.

  • wtfpython

    What the f*ck Python? 😱

    Project mention: Multidimensional lists creation, why the weird behavior | /r/Python | 2023-04-22

    Haven’t seen it mentioned in the replies, so here it is. Have a look at “What the f*ck Python? 😱” on GitHub: https://github.com/satwikkansal/wtfpython

  • Klotho

    AWS Cloud-aware infrastructure-from-code toolbox [NEW]. Build cloud backends with Infrastructure-from-Code (IfC), a revolutionary technique for generating and updating cloud infrastructure. Try IfC with AWS and Klotho now (Now open-source)

  • devdocs

    API Documentation Browser

    Project mention: Zeal is an offline documentation browser for software developers | news.ycombinator.com | 2023-05-31
  • gitbook

    📝 Modern documentation format and toolchain using Git and Markdown

    Project mention: Any tool for eBook web self-publishing? | /r/selfhosted | 2023-03-08
  • docsify

    🃏 A magical documentation site generator.

    Project mention: Ask HN: Any Sugestions for Proceures Documentation? | news.ycombinator.com | 2023-02-15

    The tools to author it aren't that important, frankly. Ask your audience what they're most comfortable using and try to meet them there.

    If the stakeholders are technical, you have more options. If they aren't, I hope you like Google Docs or Word, because if you give them anything other than that or a PDF, they'll probably complain. At worst, yeah, write it in a long Markdown text file and use tools like pandoc to transform that into other formats as needed.

    If you do need a website and you're not generating enterprise-scale amounts of content (and it sounds like you're not) try things that let you avoid needing build steps and infrastructure if at all possible, so you can iterate and deploy changes with as little friction as you can.

    Tools like Docsify[1] can take a pile of Markdown files and serve a site out of them, client- or server-side, without a static build step. Depending on the org, you can get away with GitHub's default rendering of Markdown in a repo. Most static site builds for stuff your scale are overengineered instances of premature optimization.

    Past those initial hurdles, the format and tools challenges are all in maintenance. How can you:

    - most easily keep the content up to date

    - delegate updates as the staff grows or changes

    - proactively distribute updates ASAP to the people who'd most benefit from receiving them

    That's going to depend a lot more on who'll contribute updates, what their technical proficiency's like, and how they prefer to communicate. It might be a shared git repo and RSS or Slack notifications if they're comfortable with those things, and it might be a Google Doc and email if they're like most non-technical stakeholders.

    1: https://docsify.js.org

  • professional-programming

    A collection of learning resources for curious software engineers

    Project mention: How long did it take you to code by second nature? | /r/Python | 2023-04-26

    Also this repo helps https://github.com/charlax/professional-programming

  • docz

    ✍ It has never been so easy to document your things!

    Project mention: Why aren't Node.js package managers interoperable? | dev.to | 2022-10-07

    This is a real concern. I've worked on some Yarn projects where I sometimes forget and accidentally run npm. Although these package managers (I'll call them PMs for short) are interoperable to some degree, there are important differences between these tools, so you should know what you're getting into. Even in seemingly simple projects, results can vary. Here are two reports of things working with one PM, but not another. Moreso, running install once is very different from continuous concurrent use, where you're adding and removing packages and more.

  • Wiki.js

    Wiki.js | A modern and powerful wiki app built on Node.js

    Project mention: Selbstgehostetes Wiki mit "Querverweisen"? | /r/de_EDV | 2023-05-23
  • MkDocs

    Project documentation with Markdown.

    Project mention: Ask HN: What is the best product documentation you’ve ever seen? | news.ycombinator.com | 2023-05-06

    Visual Studio App Center has excellent documentation: https://learn.microsoft.com/en-us/appcenter/distribution/cod.... It's comprehensive and well structured.

    If you're looking for a system that looks as good, mkdocs (https://www.mkdocs.org/) with the mkdocs-material theme (https://squidfunk.github.io/mkdocs-material/) can get you quite close!

  • TOAST UI Editor

    🍞📝 Markdown WYSIWYG Editor. GFM Standard + Chart & UML Extensible.

    Project mention: Is there a way to edit callouts in preview mode | /r/ObsidianMD | 2023-01-30

    - Toast UI Editor: https://ui.toast.com/tui-editor

  • electron-vue

    An Electron & Vue.js quick start boilerplate with vue-cli scaffolding, common Vue plugins, electron-packager/electron-builder, unit/e2e testing, vue-devtools, and webpack.

    Project mention: How to Use MQTT in The Electron Project | dev.to | 2022-06-19

    Address: https://github.com/SimulatedGREG/electron-vue

  • mkdocs-material

    Documentation that simply works

    Project mention: Public API documentation. What to use? | /r/golang | 2023-05-18

    I use a combo of swagger and mkdocks: https://squidfunk.github.io/mkdocs-material/

  • JSDoc

    An API documentation generator for JavaScript.

    Project mention: Comments - What's Your Style? | /r/webdev | 2023-05-20

    I use JSDoc annotations, and jsdoc package to auto-generate MarkDown and HTML documentation. I use it for [this website](zuixjs.org/). It's open source.

  • editor.md

    The open source embeddable online markdown editor (component).

    Project mention: Integrating Django Admin with Markdown Editor | dev.to | 2022-09-15

    Django-mdeditor is Markdown Editor plugin application for django base on Editor.md.

  • BookStack

    A platform to create documentation/wiki content built with PHP & Laravel

    Project mention: Imate li knowledge base, second brain? | /r/programiranje | 2023-06-02

    samo haotični tekst fajlovi za svoje beleške, a za one koje trebaju i drugi da čitaju onda markdown da bude ipak malo uređeno. A generalno za dokumentaciju bookstack

  • cheat

    cheat allows you to create and view interactive cheatsheets on the command-line. It was designed to help remind *nix system administrators of options for commands that they use frequently, but not frequently enough to remember.

    Project mention: Was looking at the GitHub page for eg and found this gem | /r/commandline | 2023-05-31

    I tried eg and tldr, but I preferred cheat. Why, and why not. Cheat not only have nice examples, but let you improve them or create yours. I use the cli, not the curl.

  • react-styleguidist

    Isolated React component development environment with a living style guide

    Project mention: 7 best ReactJS developer tools to simplify your workflow | dev.to | 2023-02-23

    React Styleguidist is a tool that generates a living style guide for React components. This tool helps developers to document and showcase their components, making it easier for other developers to understand and use them. You can visit its official website to learn more: https://react-styleguidist.js.org/.

  • zeal

    Offline documentation browser inspired by Dash

    Project mention: Zeal is an offline documentation browser for software developers | news.ycombinator.com | 2023-05-31

    It’s not widely advertised (probably this is the deal) but Zeal works fine on macOS, see this: https://github.com/zealdocs/zeal/wiki/Build-Instructions-for...

    You don’t need to build it yourself, there is a brew formula.

  • InfluxDB

    Access the most powerful time series database as a service. Ingest, store, & analyze all types of time series data in a fully-managed, purpose-built database. Keep data forever with low-cost storage and superior data compression.

NOTE: The open source projects on this list are ordered by number of github stars. The number of mentions indicates repo mentiontions in the last 12 Months or since we started tracking (Dec 2020). The latest post mention was on 2023-06-03.

Documentation related posts

Index

What are some of the best open-source Documentation projects? This list will help you:

Project Stars
1 the-art-of-command-line 136,642
2 storybook 78,931
3 mermaid 57,907
4 Docusaurus 45,051
5 tldr 44,355
6 cheat.sh 35,359
7 wtfpython 32,709
8 devdocs 31,522
9 gitbook 25,596
10 docsify 23,573
11 professional-programming 23,433
12 docz 23,270
13 Wiki.js 21,031
14 MkDocs 16,485
15 TOAST UI Editor 15,988
16 electron-vue 15,257
17 mkdocs-material 14,052
18 JSDoc 13,860
19 editor.md 13,002
20 BookStack 11,626
21 cheat 10,797
22 react-styleguidist 10,652
23 zeal 10,354
Write Clean JavaScript Code. Always.
Sonar helps you commit clean code every time. With over 300 unique rules to find JavaScript bugs, code smells & vulnerabilities, Sonar finds the issues while you focus on the work.
www.sonarsource.com