forked from ungleich-public/cdist
[DOC] include hackers manpage
Signed-off-by: Nico Schottelius <nico@kr.ethz.ch>
This commit is contained in:
parent
4b01791e69
commit
33552e5930
3 changed files with 67 additions and 0 deletions
1
Makefile
1
Makefile
|
@ -28,6 +28,7 @@ MANSRC=$(MANDIR)/cdist.text \
|
||||||
$(MANDIR)/cdist-explorer-run-global.text \
|
$(MANDIR)/cdist-explorer-run-global.text \
|
||||||
$(MANDIR)/cdist-deploy-to.text \
|
$(MANDIR)/cdist-deploy-to.text \
|
||||||
$(MANDIR)/cdist-explorer.text \
|
$(MANDIR)/cdist-explorer.text \
|
||||||
|
$(MANDIR)/cdist-hacker.text \
|
||||||
$(MANDIR)/cdist-manifest.text \
|
$(MANDIR)/cdist-manifest.text \
|
||||||
$(MANDIR)/cdist-manifest-run.text \
|
$(MANDIR)/cdist-manifest-run.text \
|
||||||
$(MANDIR)/cdist-manifest-run-all.text \
|
$(MANDIR)/cdist-manifest-run-all.text \
|
||||||
|
|
65
doc/man/cdist-hacker.text
Normal file
65
doc/man/cdist-hacker.text
Normal file
|
@ -0,0 +1,65 @@
|
||||||
|
cdist-hacker(7)
|
||||||
|
===============
|
||||||
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
||||||
|
|
||||||
|
|
||||||
|
NAME
|
||||||
|
----
|
||||||
|
cdist-hacker - How to get (stuff) into cdist
|
||||||
|
|
||||||
|
|
||||||
|
WELCOME
|
||||||
|
-------
|
||||||
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
UNDERSTANDING CDIST INTERNALS
|
||||||
|
-----------------------------
|
||||||
|
IF you are interested in how cdist internally works, you can open
|
||||||
|
bin/cdist-config and bin/cdist-deploy-to in your favorite editor and
|
||||||
|
read the scripts bin/cdist-deploy-to calls. The magnificent HACKERS_README
|
||||||
|
may be of great help as well.
|
||||||
|
|
||||||
|
|
||||||
|
HOW TO SUBMIT STUFF FOR INCLUSION INTO UPSTREAM CDIST
|
||||||
|
-----------------------------------------------------
|
||||||
|
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:
|
||||||
|
|
||||||
|
- Code submission must be done via git
|
||||||
|
- Code to be included should be branched of the upstream "master" branch
|
||||||
|
- Exception: Bugfixes to a version branch
|
||||||
|
- Code submissions must be in your master branch
|
||||||
|
- Exception: If you only want a comment on your code, but not an inclusion.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
HOW TO SUBMIT A NEW TYPE
|
||||||
|
------------------------
|
||||||
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
SEE ALSO
|
||||||
|
--------
|
||||||
|
- cdist(7)
|
||||||
|
|
||||||
|
|
||||||
|
COPYING
|
||||||
|
-------
|
||||||
|
Copyright \(C) 2011 Nico Schottelius. Free use of this software is
|
||||||
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|
|
@ -32,6 +32,7 @@ SEE ALSO
|
||||||
- Website: http://www.nico.schottelius.org/cdist/[]
|
- Website: http://www.nico.schottelius.org/cdist/[]
|
||||||
- cdist-best-practise(7)
|
- cdist-best-practise(7)
|
||||||
- cdist-deploy-to(1)
|
- cdist-deploy-to(1)
|
||||||
|
- cdist-hacker(7)
|
||||||
- cdist-manifest(7)
|
- cdist-manifest(7)
|
||||||
- cdist-quickstart(1)
|
- cdist-quickstart(1)
|
||||||
- cdist-type(7)
|
- cdist-type(7)
|
||||||
|
|
Loading…
Reference in a new issue