The documentation works in two different ways:
Handbookwhich contains all the documentation regarding all the island.is projects. You will find technical overview, architectural decisions, api, devops, code reviews, code standards detailed information and much more. If you need to edit an existing documentation or create a new page inside the handbook directory, you simply have to create a
markdownfile and start writing your content.
README.mdwhich are all the readmes from the
libsdirectories contained in the sub folders. The same goes for the README.md. Simply add your content using markdown. We only recommend one thing, is to use this template when you create a new app in the
We recommend adding an
assetsfolder inside the directory where you need it. You can then access your assets from your markdown file by doing
Once you are done with your changes, you will need to run the following command:
It will check for any new files created inside the
handbookdirectory or new
README.mdlocated inside the
libsdirectories and add it to the
SUMMARY.mdfile, which is the file used by GitBook to create the navigation structure.
The script will also format the README.md's title to follow the APA style convention. All files added the the
SUMMARY.mdwill be alphabetically ordered and organised in folders/sub-folders for the