Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vipulgupta2048/awesome-documentation

A curated list of awesome documentation websites ✍️💯
https://github.com/vipulgupta2048/awesome-documentation

List: awesome-documentation

accessiblity awesome-list best-practices docs documentation guides hacktoberfest internationalization references tutorials

Last synced: about 1 month ago
JSON representation

A curated list of awesome documentation websites ✍️💯

Awesome Lists containing this project

README

        

# Awesome Documentation [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)

> A curated list of awesome real-life documentation examples

![GitHub issues](https://img.shields.io/github/issues-raw/vipulgupta2048/awesome-documentation?color=brightgreen&style=plastic) ![GitHub labels](https://img.shields.io/github/labels/vipulgupta2048/awesome-documentation/help-wanted?color=red&style=plastic) ![Maintenance](https://img.shields.io/maintenance/yes/2020?style=plastic&color=blueviolet) [![CC-0 license](https://img.shields.io/badge/License-CC--0-blue.svg)](https://creativecommons.org/licenses/by-nd/4.0) [![Open Source Love png1](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://github.com/ellerbrock/open-source-badges/) ![ViewCount](https://views.whatilearened.today/views/github/vipulgupta2048/awesome-documentation.svg)

## Motivation behind the list

Once upon a time, I set out to find a single **awesome** _community-curated_ `resource` that provided great examples of docs available all over the web. I couldn't find one and neither could my friend, Justin. So I created one and you are welcome! That's how awesome-documentation began.

![](https://user-images.githubusercontent.com/22801822/99884009-f25b2f00-2c50-11eb-8d7c-a47387fb0c39.png)

🎯 Each item is categorized according to sections.
👌 Focused on providing concrete examples & great inspiration to fellow documentarians.
📄 Some items feel they need to be there in other sections as well just because of how good they are but I want to keep duplicates to a minimum.
👂 Looking forward to any and all suggestions!

## Table of Contents

Each of the headings listed below corresponds to an actual section of documentation. Each heading contains examples of docs that are equal parts captivating, interesting, and inspiring for the readers. If the code for the documentation site is open-source, please do update it by putting a link right next to it.

- [Getting Started](#getting-started)
- [Tutorials & Guides](#tutorials--guides)
- [References](#references)
- [Cookbooks](#cookbooks)
- [API/SDK](#apisdk)
- [Neat ways of versioning the docs](#neat-ways-of-versioning-the-docs)
- [CLI](#cli)
- [Enterprise](#enterprise)
- [Great Discoverablity in Docs](#great-discoverablity-in-docs)
- [Keeping it Super Simple (KISS)](#keeping-it-super-simple-kiss)
- [Focus on Accessiblity (a11y)](#focus-on-accessiblity-a11y)
- [Focus on Internationalization (i18n)](#focus-on-internationalization-i18n)
- [Changelog](#changelog)
- [Others](#others)

---

## All-stars of documentation!

> 🌟 The best of the best overall 🌟

- [Gitlab](https://about.gitlab.com/resources/) - Gitlab's accurate docs coupled with the flow of information and scale they handle sets them apart to be a prime example for technical, non-technical as well as internal documentation. Their handbook, guides, tutorials are extremely well done. Look no further.
- Looking forward to reviewing & adding more to the list below, [Hit me up!!](https://twitter.com/vipulgupta2048) or make a pull request of your own! It's all good!

## Getting Started

- [Django getting started](https://www.djangoproject.com/start/) - https://github.com/django/django/tree/master/docs
- [balena getting started](https://www.balena.io/docs/learn/getting-started/raspberrypi3/nodejs/) - https://github.com/balena-io/docs
- [Docker getting started](https://docs.docker.com/get-started/) - https://github.com/docker/docker.github.io/
- [Prisma Getting Started](https://www.prisma.io/docs/getting-started/quickstart-typescript)
- [Create React App](https://create-react-app.dev/docs/getting-started)

## Tutorials & Guides

- [Gatsby tutorials](https://www.gatsbyjs.com/tutorial/)
- [DigitalOcean tutorials](https://www.digitalocean.com/community/tutorials)
- [Twilio guides](https://www.twilio.com/docs/whatsapp/tutorial/send-whatsapp-notification-messages-templates)
- [Repl.it tutorials](https://docs.replit.com/tutorials/overview)
- [Webflow tutorials](https://university.webflow.com/lesson) - Special mention to the Webflow for the work they have put into their tutorials. These form a prime example of a quote I like which goes like.

> The difference between good work and great work is just a little extra effort & attention to detail. Something as a documentarian we should always try to look out for.

## References

- [Docker references](https://docs.docker.com/reference/)

## Cookbooks & Integrations

- [spaCy code examples](https://spacy.io/usage/examples) as well as [spaCy Guides](https://spacy.io/usage/linguistic-features)
- [Vercel Guides](https://vercel.com/guides)

## API/SDK

- [Stripe API reference](https://stripe.com/docs/api)
- [FrontApp API reference](https://dev.frontapp.com/reference/introduction)
- [FastAPI API framework](https://fastapi.tiangolo.com/)
- [Razorpay API reference](https://razorpay.com/docs/api/)

## Neat ways of versioning the docs

- [GitHub docs](https://docs.github.com/en/free-pro-team@latest/github) - [Github Repository](https://github.com/github/docs)
- Need more suggestions, checkout issues and contribute yours.

## CLI

- [Click](https://click.palletsprojects.com/en/7.x/)
- [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli)

## Enterprise

- [GitHub for Enterprise](https://docs.github.com/en/[email protected]/admin)
- [Gitlab Maturity Document](https://about.gitlab.com/direction/maturity/)

## Great Discoverability in Docs

Docs having pretty as heck, landing pages intelligently leaking details about the product, getting started, ways ahead, guides, maybe even their CLI, integrations, SDK, or API.

- [Terraform Docs](https://www.terraform.io/docs/index.html)
- [Lodash docs](https://lodash.com/docs/4.17.15)
- [RazorPay Docs](https://razorpay.com/docs/)
- [Algolia Docs](https://www.algolia.com/doc/)

## Keeping it Super Simple (KISS)

- [Asana Docs](https://asana.com/guide)
- [Fast Logins Docs](https://www.fast.co/docs)

## Focus on Accessiblity (a11y)

- [Web Content Accessibility Guidelines](https://www.w3.org/TR/WCAG21/)
- [Accessibility | MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
- [Webflow Resources](https://a11yresources.webflow.io/)

## Focus on Internationalization (i18n)

- Need more suggestions, checkout issues, and contribute yours.

## Changelog

- [GatherContent](https://gathercontent.com/whats-new)
- [Todoist changelogs](https://get.todoist.help/hc/en-us/sections/360004759319-Changelogs)
- [Notion Changelogs](https://www.notion.so/What-s-New-157765353f2c4705bd45474e5ba8b46c) - Incredible example of dogfooding.

## Others
- [Notion Help & Support](https://www.notion.so/Help-Support-e040febf70a94950b8620e6f00005004)