From 19000c853ceecdf86082174c7c7f237fb4d73027 Mon Sep 17 00:00:00 2001 From: Josh Cooper Date: Thu, 29 Nov 2018 13:20:08 -0800 Subject: Add anchors for l10n Also remove relative REFERENCE.md link as that doesn't work on the forge. --- README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 8a58912..b686b1f 100644 --- a/README.md +++ b/README.md @@ -6,22 +6,26 @@ 1. [Description](#description) 2. [Setup - The basics of getting started with augeas_core](#setup) * [Setup requirements](#setup-requirements) - * [Beginning with augeas_core](#beginning-with-augeas_core) + * [Beginning with augeas_core](#beginning-with-augeas) 3. [Usage - Configuration options and additional functionality](#usage) 4. [Reference - An under-the-hood peek at what the module is doing and how](#reference) 5. [Limitations - OS compatibility, etc.](#limitations) 6. [Development - Guide for contributing to the module](#development) + ## Description The `augeas_core` module is used to manage configuration files using Augeas. This module is suitable for any host for which there are Augeas libraries and ruby bindings. + ## Setup + ### Setup Requirements The augeas libraries and ruby bindings must be installed in order to use this module. If you are using `puppet-agent` packages, then those prerequisites are already satisfied for most platforms. + ### Beginning with augeas_core To manage a configuration file using `augeas`, use the following code: @@ -40,13 +44,15 @@ augeas { 'add_services_entry': } ``` + ## Usage -For details on usage, please see the [reference documentation](REFERENCE.md) and [examples](https://puppet.com/docs/puppet/latest/resources_augeas.html). +Please see REFERENCE.md for the reference documentation and [examples](https://puppet.com/docs/puppet/latest/resources_augeas.html) for details on usage. + ## Reference -Please see [`REFERENCE.md`](REFERENCE.md) for the reference documentation. +Please see REFERENCE.md for the reference documentation. This module is documented using Puppet Strings. @@ -59,10 +65,12 @@ bundle exec puppet strings generate ./lib/**/*.rb ``` This command will create a browsable `_index.html` file in the `doc` directory. The references available here are all generated from YARD-style comments embedded in the code base. When any development happens on this module, the impacted documentation should also be updated. + ## Limitations This module is only available on platforms that have augeas libraries and ruby bindings installed. + ## Development Puppet Labs modules on the Puppet Forge are open projects, and community contributions are essential for keeping them great. We can't access the huge number of platforms and myriad of hardware, software, and deployment configurations that Puppet is intended to serve. -- cgit v1.2.3