| martin f. krafft | 3cd2a33 | 2014-10-28 15:58:23 +0100 | [diff] [blame] | 1 | ================================================ |
| 2 | reclass — Recursive external node classification |
| 3 | ================================================ |
| 4 | .. include:: intro.inc |
| 5 | |
| 6 | Releases and source code |
| 7 | ------------------------ |
| 8 | The latest released |reclass| version is |release|. Please have a look at the |
| 9 | :doc:`change log <changelog>` for information about recent changes. |
| 10 | |
| 11 | For now, |reclass| is hosted `on Github`_, and you may clone it with the |
| 12 | following command:: |
| 13 | |
| 14 | git clone https://github.com/madduck/reclass.git |
| 15 | |
| 16 | Please see the :doc:`install instructions <install>` for information about |
| 17 | distribution packages and tarballs. |
| 18 | |
| 19 | .. _on Github: https://github.com/madduck/reclass |
| 20 | |
| 21 | Community |
| 22 | --------- |
| 23 | There is a `mailing list`_, where you can bring up anything related to |
| 24 | |reclass|. |
| 25 | |
| 26 | .. _mailing list: http://lists.pantsfullofunix.net/listinfo/reclass |
| 27 | |
| 28 | For real-time communication, please join the ``#reclass`` IRC channel on |
| 29 | ``irc.oftc.net``. |
| 30 | |
| 31 | If you're using `Salt`_, you can also ask your |reclass|-and-Salt-related |
| 32 | questions on the mailing list, ideally specifying "reclass" in the subject of |
| 33 | your message. |
| 34 | |
| 35 | Licence |
| 36 | ------- |
| 37 | |reclass| is © 2007–2014 by martin f. krafft and released under the terms of |
| 38 | the `Artistic Licence 2.0`_. |
| 39 | |
| 40 | Contents |
| 41 | -------- |
| 42 | These documents aim to get you started with |reclass|: |
| 43 | |
| 44 | .. toctree:: |
| 45 | :maxdepth: 2 |
| 46 | |
| 47 | install |
| 48 | concepts |
| 49 | operations |
| 50 | usage |
| 51 | refs |
| 52 | manpage |
| 53 | configfile |
| 54 | salt |
| 55 | ansible |
| 56 | puppet |
| 57 | hacking |
| 58 | todo |
| 59 | changelog |
| 60 | |
| 61 | About the name |
| 62 | -------------- |
| 63 | "reclass" stands for **r**\ ecursive **e**\ xternal node **class**\ ifier, |
| 64 | which is somewhat of a misnomer. I chose the name very early on, based on the |
| 65 | recursive nature of the data merging. However, to the user, a better paradigm |
| 66 | would be "hierarchical", as s/he does not and should not care too much about |
| 67 | the implementation internals. By the time that I realised this, unfortunately, |
| 68 | `Hiera`_ (Puppet-specific) had already occupied this prefix. Oh well. Once you |
| 69 | start using |reclass|, you'll think recursively as well as hierarchically at |
| 70 | the same time. It's really quite simple. |
| 71 | |
| 72 | .. |
| 73 | Indices and tables |
| 74 | ================== |
| 75 | |
| 76 | * :ref:`genindex` |
| 77 | * :ref:`modindex` |
| 78 | * :ref:`search` |
| 79 | |
| 80 | .. include:: extrefs.inc |
| 81 | .. include:: substs.inc |