Skip to content

kleihan/document

 
 

Repository files navigation

Documentation demo

If you see this README.md file in GitHub website, please click directly on GitHub pages of this project, so you can see it in action, rendered in all it's beauty. However, via GitHub website, you can check real source code of these files simply by browsing the repository. For example, index.html is stored here.

!> This document is mobile ready! Try opening the page in your cellphone!

?> Also, it is print friendly.

Why

This repository serves as an example of fictitious documentation, stored in form of the source code (mainly MarkDown syntax) in GitHub.
This way you can utilise GitHub Workflow process to control changes over various types of documentation. Workflow itself is capable to replace existing approval tools (ie. Alfresco, EEPR etc.), but to figure out, how to "translate" your current work into form of the source code is the main challenge here.

What

This whole documentation page is described with MarkDown syntax, using some external libraries.
Main renderer is Docsify, but as you will see in other chapters (see sidebar menu), we inject certain libraries to enable charts, graphs and mathematical equations.
There are many alternatives to Docsify, using native Jekyll or whatever.
Final result is rendered as static webpage, using GitHub pages for hosting the result.

Where

What you read now is content of default README.md file in root of repository. As this suppose to be publicly available demo, you can have a look directly at source code repository, to better understand, how this was actually made.

About

Sample of possible documentation approach.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 100.0%