Documentation Guidelines

Our wiki is based on the Open Source application called BookStack. Check the documentation.

Content Organization

The content of our wiki is organized following the PARA Method. It is based on 4 simple categories of content:

Category	Description
Projects / Products	Definition: Time-bound efforts that we are working on now.    Akvo: This is where we centralize the documentation about our current active projects and products.
Areas	Definition: Long term knowledge areas that we want proactively manage.   Akvo: This is where we document our internal processes, SOP and knowledge about our areas of expertise.
Resources	Definition: Topics or interests that might useful in the future.   Akvo: This is where we compile useful links and documents, reading lists, list of conferences, etc...
Archive	Definition: Inactive items from the other 3 categories.

Shelves > Books > Chapters > Pages

Project sheet

Name Project Scope
Contract Link Start Date End Date PMT Link Tech Stack Repo Asana Link (project or team) Slack Channel Link

Archiving things

Templates

Content Formatting

It is important to produce documentation that is pleasant to read. BookStack Tipsoffers a rather clean theme and a set of features that help users navigate properly the wiki. You should use BookStack feature whenever possible.

Use the 

Mastering BookStack

Our wiki is based on the Open Source application called BookStack. It provides a wide range of use features that you would expect from standard wiki software, and more.

Code Blocks

Diagrams

Templates

Collapsible Blocks

Table Formatting

API