kunzhoudk / workspace

Binbash Leverage Reference Architecture

Overview

This repository contains all files used to create Binbash Leverage Reference Documentation

Branches

• master --> contains the source code
• gh-pages --> deployable (builded) version

Deployed Documentation

Check it out here.

Development / Contributing

1. Clone the repo locally
2. Config your MkDocs env including the navigation tree directory via mkdocs.yml file.
3. Spin up your MkDocs local dev web server environment (http://localhost:8000) (real time updates we'll be shown) via Makefile cmd

 make docs-live          

4. Update necessary *.md files inside the docs/ folder and check your updates through the local environment browser
5. And create your PR from BBL-XXX to master branch.
6. The Github Pages site https://leverage.binbash.com.ar will be automatically deployed via CircleCI job to the gh-pages branch (currently being built from this branch).
   • It currently uses the make docs-deploy-gh cmd which could be locally executed if needed too.

TODO

• Several sections needs completion or update.