Towerify docs

Cette repo contient la documentation de Towerify.

Elle est écrite dans des fichiers en MarkDown et elle est générée grâce à Material for MkDocs.

Modifier la documentation en local

Commencer, bien sûr, par cloner cette repo.

git clone https://github.com/computablefacts/towerify-docs.git

Installer Material for MkDocs et ses dépendances (MkDocs nécessite python v3.x) :

pip install -r requirements.txt

Lancer le serveur pour voir la documentation dans son navigateur :

mkdocs serve

Si tout se passe bien, MkDocs affiche ceci :

INFO    -  Building documentation...
INFO    -  Cleaning site directory
INFO    -  Documentation built in 0.47 seconds
INFO    -  [23:06:06] Watching paths for changes: 'docs', 'mkdocs.yml'
INFO    -  [23:06:06] Serving on http://127.0.0.1:8000/

Accéder à l'URL affichée dans son navigateur permet de voir la documentation.

Si on affiche une page de la doc dans son navigateur et qu'on modifie le fichier correspondant de la doc depuis son IDE, la page du navigateur se met à jour au fur et à mesure sans avoir besoin de la rafraîchir.

Pratique si on possède deux écrans : IDE pour modifier la doc sur le premier et navigateur pour voir les modifications sur le deuxième.

Publier la documentation

Nous publions grâce à Towerify CLI.

Pour déployer en DEV :

towerify deploy --env dev --profile cywise

La doc de DEV est accessible sur : https://dev.docs.towerify.io/.

Pour déployer en PROD :

towerify deploy --env prod --profile cywise

La doc de PROD est accessible sur : https://docs.towerify.io/.