The odo website is fed from different sources:
- The top level README.md file
- The documents in the sub folders (recursively)
- The API documentation
All these resources are related to a specific branch. They are "compiled" using the
_build script in the jekyll folder on a the branch, which in turn generates html files in the pages repository (which contains the web site).
However, from the perspective of the development process, I may want to have different sources for this information:
- A start page, which is not necessarily the same as the top level README.md
- The documents and the API documentation mentioned above, but maybe not from the main branch, but from another one.
And we need a concept that allows updating all these items separately, without "polluting" a development branch with documentation changes. The target would be to have zero changes on a development branch, even if it provides all or some of the documents on the website.
Deleting a branch is permanent. It CANNOT be undone. Continue?