Intro to importing generated docs from external projects
How to import generated content from external repos?
Unlike static content generated content is not available right off from the external repo.
The suggested approach is as follows:
- On external project set up scripts/hooks that
- generate docs into markdown
- commit generated docs into an orphaned commit and associated dedicated branch
- push orphaned commit to remote
- emit publication event for centralized docs project
- intercept delete branch event and delete dedicated branch
- On centralized documentation project:
- connect external repo with
subrepo clone ...
or intercept publication event - import remote dedicated branch with
subrepo pull ... && subrepo clean ...
- emit delete branch event for external project
- build and publish centralized docs
- connect external repo with