---
# System prepended metadata

title: Cloud Native Documentation

---

# Cloud Native Documentation

## Prerequisites

You need VS Code to write docs

- install [docsify](https://docsify.js.org/#/)
    - npm i docsify-cli -g
- install VSCode plugins
    - PlantUML
    - [MarkdownAllInOne](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
    - [MarkdownLint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)
    - Markdown Preview Enchanced

## Create Repositories

First you need a repository where documentation will be. [Use naming convention](https://dev.azure.com/GRD-EMEA/Cloud%20Native%20Platform/_wiki/wikis/Cloud%20Native%20Platform%20Wiki/1094/NAMING-CONVENTIONS). 

Clone and create *docs* folder. On the repo root, run `docsify init ./docs`

To run docsify generator use `docsify serve docs` from root repo. Navigate to web site (it will be localhost:3000).


## Tips & Tricks

- Read docsify documentaiton
- Explore [docsify themed](https://jhildenbiddle.github.io/docsify-themeable/#/introduction) for more themes and graphical bells and whistles
- To use code highlighting for *any* language add desired language from [prismjs CDN](https://cdn.jsdelivr.net/npm/prismjs@1/components/)
