yuzutech / blog.yuzutech.fr

Code, content and configuration for blog.yuzutech.fr
https://blog.yuzutech.fr
6 stars 6 forks source link

Blog post: From GitBook to Antora should mention the git repo more #3

Closed djencks closed 4 years ago

djencks commented 4 years ago

I think one of the more confusing aspects of Antora for beginners is the relationship between the git repo(s) involved and the playbook configuration. So, explicitly mentioning the location of the git repo implied by the playbook would be valuable. I'd probably discuss why it's a good idea to have separate repos for the playbook and component, but that might be too complex for this article.

It might also be nice to update site.yml to the currently recommended antora-playbook.yml.