https://alfrepo.github.io/blog/
- custom template: Design the list of articles - as a less bloaghted, one liners
mkdocs new [dir-name] - Create a new project.
mkdocs serve - Start the live-reloading docs server.
mkdocs build - Build the documentation site.
mkdocs -h - Print help message and exit.
# Start the live-reloading docs server.
mkdocs serve --config-file ./content/mkdocs.yml --dev-addr 0.0.0.0:8080
GitHub actions config file under .github\workflows\deploy-github-pages.yml
# uses shell\installmkdocs.sh
- how do services communicate?
- how to make sure, that the services scale separately?
- how to document event-driven instrfaces?
- async API
- schemas
- how to communicate with apps synchronously?
- how to document sync apis?
- ownership: how to implement ownership of components?
- how to apply DDD to define service boundaries?
- how to authorize? authenticate?
- Architecture?
- Who tracks quality?
- Wwho expresses what is needed?
- Who makes sure the solutions do fit together in an enterprise
- and why S.A.F.E. is good for enterprises
- different IAM solutions in cloud: AD, LDAP,
- how to enforce?
- how to maintain?
- which model to follow?
- custom or off the shelf?
- Kubernetes - Kubernitis
- Containers
- Serverless