Skip to main content

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 

image.png

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