Closed inoxx03 closed 6 years ago
Looks like we might have this already in the guide: https://redhat-documentation.github.io/community-collaboration-guide/#ccg-asciidoc-attributes but it could use some beefing up probably.
@nengard Right, my bad:) I completely skipped over that one and missed it when checking the guide.I'll go over the existing content to see where and how it can be improved:)
No worries! I did too! I'm the one who said we didn't have it in the guide yet :)
+1 to @inoxx03 suggestions, in particular how to "build out" link URLs with replaceables/variables. It's a great way to avoid hardcoding and really powerful for that reason.
Also, how to handle the product attributes file would be useful, since that's where things can get tricky if you are mirroring the upstream repo downstream. Since I'm working through this right now, I can write up my findings after I get it all figured out.
The content for this section should briefly explain:
attributes.adoc
file is and why is it useful when creating booksdoctype
must be specified)attributes.adoc
. (an embeddedadoc
source with callouts on important lines would be the fomatting I'd prefer, but I'm open to suggestions here:))Please feel free to add content suggestions for useful information that the chapter should include, if anything comes to your mind:)