| 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 | |
| martin f. krafft | 03266f6 | 2013-08-27 22:03:30 +0200 | [diff] [blame] | 27 | Or use the Debian package, as explained in the :doc:`install instructions |
| 28 | <install>`. |
| 29 | |
| martin f. krafft | 0b157d6 | 2013-08-27 18:52:47 +0200 | [diff] [blame] | 30 | .. _on Github: https://github.com/madduck/reclass |
| 31 | |
| 32 | If you want a tarball, please `obtain it from the Debian archive`_. |
| 33 | |
| 34 | .. _obtain it from the Debian archive: http://http.debian.net/debian/pool/main/r/reclass/ |
| 35 | |
| 36 | Licence |
| 37 | ------- |
| 38 | |reclass| is © 2007–2013 by martin f. krafft and released under the terms of |
| 39 | the `Artistic Licence 2.0`_. |
| 40 | |
| martin f. krafft | 8acd49d | 2013-08-26 21:22:25 +0200 | [diff] [blame] | 41 | Contents |
| 42 | -------- |
| 43 | These documents aim to get you started with |reclass|: |
| 44 | |
| 45 | .. toctree:: |
| 46 | :maxdepth: 2 |
| 47 | |
| 48 | install |
| 49 | concepts |
| 50 | operations |
| 51 | usage |
| martin f. krafft | 82c4b6f | 2013-08-27 19:05:11 +0200 | [diff] [blame] | 52 | refs |
| martin f. krafft | 8acd49d | 2013-08-26 21:22:25 +0200 | [diff] [blame] | 53 | manpage |
| 54 | configfile |
| 55 | salt |
| 56 | ansible |
| 57 | puppet |
| 58 | hacking |
| martin f. krafft | cc8851d | 2013-08-27 13:43:16 +0200 | [diff] [blame] | 59 | todo |
| martin f. krafft | 069f53c | 2013-08-27 17:50:03 +0200 | [diff] [blame] | 60 | changelog |
| martin f. krafft | 8acd49d | 2013-08-26 21:22:25 +0200 | [diff] [blame] | 61 | |
| martin f. krafft | 8acd49d | 2013-08-26 21:22:25 +0200 | [diff] [blame] | 62 | About the name |
| 63 | -------------- |
| 64 | "reclass" stands for **r**\ ecursive **e**\ xternal node **class**\ ifier, |
| 65 | which is somewhat of a misnomer. I chose the name very early on, based on the |
| 66 | recursive nature of the data merging. However, to the user, a better paradigm |
| 67 | would be "hierarchical", as s/he does not and should not care too much about |
| 68 | the implementation internals. By the time that I realised this, unfortunately, |
| 69 | `Hiera`_ (Puppet-specific) had already occupied this prefix. Oh well. Once you |
| 70 | start using |reclass|, you'll think recursively as well as hierarchically at |
| 71 | the same time. It's really quite simple. |
| 72 | |
| 73 | .. |
| 74 | Indices and tables |
| 75 | ================== |
| 76 | |
| 77 | * :ref:`genindex` |
| 78 | * :ref:`modindex` |
| 79 | * :ref:`search` |
| 80 | |
| 81 | .. include:: extrefs.inc |
| 82 | .. include:: substs.inc |