#40: Doc: Recipe XML Format Reference on Wiki -----------------------+----------------------------------------- Reporter: rpazdera | Owner: rpazdera Type: task | Status: new Priority: major | Milestone: Complete Wiki Documentation Component: wiki | Version: Resolution: | Keywords: Blocked By: | Blocking: -----------------------+-----------------------------------------
Comment (by rpazdera):
Replying to [comment:5 jtluka]:
Replying to [comment:4 rpazdera]:
I just finished writing this. It is available on wiki:
https://fedorahosted.org/lnst/wiki/Documentation/RecipeXMLFormatReference
It grew a lot :-/. I tried to make it a bit easier to read by adding
a custom generated LNST Recipe XML map. It serves as a kind of click- through index for quick access to individual tags within the manual.
I really like it, the map is very easy to read, great work! I've read
through the document and it seems to me quite clear.
I have only one suggestion for enhancement. The tag's description tables
under 2.3 MachineRequires and 2.3 NetConfig chapter looks a bit messy. I propose to at least add a tag title before any tag's description table under machinerequires/netconfig tag, for example something similar to "Slaves","Options","Bonding example" titles under 2.3.2 Bonding.
Thanks for the feedback! You are right. That particular section is quite crammed (that is why I decided to make the map). I'll see what I can do :).
lnst-developers@lists.fedorahosted.org