Skip to content

Latest commit

 

History

History
141 lines (84 loc) · 6.58 KB

README.md

File metadata and controls

141 lines (84 loc) · 6.58 KB

Awesome Documentation Awesome

A curated list of awesome real-life documentation examples

GitHub issues GitHub labels Maintenance CC-0 license Open Source Love png1 ViewCount

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.

🎯 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.


All-stars of documentation!

🌟 The best of the best overall 🌟

  • Gitlab - 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!! or make a pull request of your own! It's all good!

Getting Started

Tutorials & Guides

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

Cookbooks & Integrations

API/SDK

Neat ways of versioning the docs

CLI

Enterprise

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.

Keeping it Super Simple (KISS)

Focus on Accessiblity (a11y)

Focus on Internationalization (i18n)

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

Changelog

Others