Table of Contents
Welcome dear hacker! I invite you to a tour of pointers to get into the usable configuration mangament system, cdist.
The first thing to know is probably that cdist is brought to you by people who care about how code looks like and who think twice before merging or implementing a feature: Less features with good usability are far better than the opposite.
If you believe you’ve found a bug and verified that it is in the latest version, drop a mail to the cdist mailing list, subject prefixed with "[BUG] " or create an issue on github.
If something should be better done or needs to fixed, add the word FIXME nearby, so grepping for FIXME gives all positions that need to be fixed.
Indention is 4 spaces (welcome to the python world).
If you did some cool changes to cdist, which you value as a benefit for everybody using cdist, you’re welcome to propose inclusion into upstream.
There are though some requirements to ensure your changes don’t break others work nor kill the authors brain:
As soon as your work meets these requirements, you can contact me (IRC, Mailinglist, Phone, RFC 1149) and I’ll check your code before including it.
For detailled information about types, see cdist-type(7).
Submitting a type works as described above, with the additional requirement that a corresponding manpage named man.text in asciidoc format with the manpage-name "cdist-type__NAME" is included in the type directory AND asciidoc is able to compile it (i.e. do NOT have to many "=" in the second line).
Warning: Submitting "exec" or "run" types that simply echo their parameter in gencode* will not be accepted, because they are of no use. Every type can output code and thus such a type introduces redundant functionality that is given by core cdist already.