Unify publishing docs and blog from all repos
- Unify publishing of docs / blogs
- Same format everywhere
- Make it easy to do it from all repos (e.g., tutorials, helpers)
- In //tutorials
- > ls notes.
- notes.programming_with_ai/ notes.startup_admin_guide/
- https://docs.google.com/document/d/1PfSQgCMV2mT7bVyb7HMgiokU5nZgn_4BEJAfFvISSPM/edit?tab=t.tv7qcq9qny6b#heading=h.2s8ka062y77x
- ./helpers_root/docs/documentation_meta/all.mkdocs_deployment.how_to_guide.md
We publish from several different repos, and several types of materials (e.g., blogs, documentation, notes)
- [ ] Document a list of everything we publish and from where
From //helpers Helpers docs dev_scripts_helpers/documentation/mkdocs/mkdocs.yml https://causify-ai.github.io/helpers/
From //cmamp Cmamp docs ./mkdocs.yml ?
From //tutorials Causify blog ./blog/mkdocs.yml blog.causify.ai
From //tutorials ./notes.programming_with_ai/mkdocs.yml ./notes.startup_admin_guide/mkdocs.yml
-
[ ] Make sure that the layout of the files is always the same across all the publications
-
We want to have all the files inside a dir (including mkdocs)
-
See "Layout of a publishable dir" ./docs/documentation_meta/all.mkdocs_deployment.how_to_guide.md
-
[ ] Document how to instrument a repo to publish on GitHub
-
[ ] Finish the documentation ./docs/documentation_meta/all.mkdocs_deployment.how_to_guide.md
@Vedanshu7 you can sync with @heanhsok since he did the work so far