Skip to content

Latest commit

 

History

History
23 lines (14 loc) · 1.92 KB

README.md

File metadata and controls

23 lines (14 loc) · 1.92 KB

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.