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