cleanup document listing - now only worry about writing them

Signed-off-by: Nico Schottelius <nico@brief.schottelius.org>
This commit is contained in:
Nico Schottelius 2012-01-11 17:34:09 +01:00
parent c26058efcc
commit f8e80d6422
2 changed files with 57 additions and 61 deletions

View file

@ -18,6 +18,8 @@
- cdist-stages.text - cdist-stages.text
- cdist-type.text - cdist-type.text
51 -> ssh stuff double: cdist-best-practice and here
-------------------------------------------------------------------------------- --------------------------------------------------------------------------------

View file

@ -14,83 +14,77 @@ This document gives you a pointer on what to read in
which order and is thus more a "guide to the right locations". which order and is thus more a "guide to the right locations".
cdist-quickstart:: cdist-quickstart::
Read this, if you are brand new in the cdist world and just want New to cdist? Want to get your hands dirty? Read this. [beginner]
to get your hands dirty.
cdist-reference::
Know everything about cdist: the types, explorers or environment
variables usable.
PARTS BELOW HERE ARE TO-BE-DONE
cdist-installation:: cdist-installation::
The comprehensive guide to your first cdist installation. The comprehensive guide to your first cdist installation [beginner]
cdist-manifest::
initial in here
cdist-best-practice::
cdist-explorer::
cdist-hacker::
cdist-stages::
cdist-type::
-> ssh stuff double: cdist-best-practice and here
CONTINUE READING
----------------
So far you have seen how to get cdist up and running and
how the initial manifest is being used.
- MANAGING YOUR OWN CONFIGURATION
own branch => very early [before first change?] own branch => very early [before first change?]
=> no, first quick intro, then do it right => no, first quick intro, then do it right
It is recommended to
- MANAGING YOUR OWN CONFIGURATION cdist-initial-manifest::
- write own type Learn how to define which hosts get which configurations [beginner]
cdist-type::
Understand how types are working and created [intermediate]
CREATING YOUR FIRST OWN TYPE
----------------------------
=> short example, reference to cdist-type(7)!
=> motivation
Use a type to bundle functionalitY
<with object id? or signleton here already>
Debug with var - can be used by yourself
__debug::
If this variable is setup, cdist runs in debug mode.
You can use this information, to only output stuff in debug
mode as well.
Available for: initial manifest, type manifest, gencode, code
MANAGING YOUR OWN CONFIGURATION USING EXPLORERS
------------------------------- ---------------
cdist-explorer.text
CREATING YOUR FIRST OWN TYPE DEBUGGING YOUR TYPES
---------------------------- --------------------
=> short example, reference to cdist-type(7)!
=> motivation
Use a type to bundle functionalitY
<with object id? or signleton here already>
Debug with var - can be used by yourself
__debug::
If this variable is setup, cdist runs in debug mode.
You can use this information, to only output stuff in debug
mode as well.
Available for: initial manifest, type manifest, gencode, code
cdist-best-practice::
Hints from real life experience to help you to organise cdist [intermediate]
USING EXPLORERS cdist-reference::
--------------- The type, explorers and environment variables reference [intermediate]
cdist-explorer.text
cdist-explorer::
Interested in getting more information about the target system? [intermediate]
cdist-cache::
How to get use information about the hosts we have been working on [advanced]
cdist-scaling-tuning::
How to scale out with cdist and which tunings to apply. [advanced]
TUNING CDIST
------------
- speedup processing with ControlMaster option of
ssh
=> different document
DEBUGGING YOUR TYPES cdist-stages::
-------------------- Understand the internal workflow of cdist. [advanced]
cdist-hacker::
README, if you want to extend or modify cdist. [hacker]
TUNING CDIST
------------
- speedup processing with ControlMaster option of
ssh
=> different document
SEE ALSO SEE ALSO
-------- --------