inspec/docs
Matthew Dromazos 0cbe5b60e5 New Skeletal Resource aws_config_delivery_channel (#2641)
* Initial commit of new skeletal resource aws_config_delivery_channel
* Changes delivery_frequency to be an integer and names delivery_frequency_in_hours
* Adds more documentation and clarifies descriptions
* Wraps API call in the aws_catch_errors function
* Changes config bucket name to use dashes instead of underscores
* Updates on master and changes directory location of build and integration files
* Fix integration tests to only create one ConfigRecorder

Signed-off-by: Matthew Dromazos <dromazmj@dukes.jmu.edu>
2018-03-26 14:03:23 -04:00
..
resources New Skeletal Resource aws_config_delivery_channel (#2641) 2018-03-26 14:03:23 -04:00
shared fix ident in cmp matcher docs 2017-03-02 12:28:50 +01:00
.gitignore ignore auto-generated docs 2016-09-22 16:47:54 +02:00
dsl_inspec.md Fix typo in some docs (#2841) 2018-03-20 08:43:30 -04:00
dsl_resource.md Documentation: supports attribute of custom resource DSL (#2824) 2018-03-22 08:47:31 -04:00
glossary.md Adds glossary.md file (#2450) 2018-02-08 10:00:51 +01:00
habitat.md Add docs for habitat CLI commands 2017-03-28 13:59:38 -04:00
inspec_and_friends.md Docs: Describe support boundary between RSpec and InSpec (#2753) 2018-03-08 20:22:34 -08:00
matchers.md Add additional links to Learn Chef Rally content (#2477) 2018-03-14 11:01:12 -04:00
migration.md Fix typo in some docs (#2841) 2018-03-20 08:43:30 -04:00
platforms.md edits to platforms doc (#2695) 2018-02-19 23:29:19 +01:00
plugin_kitchen_inspec.md Add additional links to Learn Chef Rally content (#2477) 2018-03-14 11:01:12 -04:00
profiles.md Add additional links to Learn Chef Rally content (#2477) 2018-03-14 11:01:12 -04:00
README.md generate docs for cli 2016-09-22 13:43:57 +02:00
reporters.md Fix typo in some docs (#2841) 2018-03-20 08:43:30 -04:00
ruby_usage.md Corrects capitalization (#2764) 2018-03-05 09:07:06 -05:00
shell.md Add additional links to Learn Chef Rally content (#2477) 2018-03-14 11:01:12 -04:00

InSpec documentation

This is the home of the InSpec documentation. This documentation provides an introduction to this mechanism and shows how to write custom tests.

The goal of this folder is for any community member to clone these docs, make the changes, check if they are valid, and contribute to the project.

How to build docs

We build docs by:

  1. Auto-generating docs from code
  2. Transforming markdown+snippets in this folder into pure markdown in www/source/docs
  3. Rendering them to the website via instructions in www/

For development, you only need step 1!

1 Generate docs

To generate all docs run:

bundle exec rake docs

You can run tasks individually. For a list of tasks run:

bundle exec rake --tasks docs

Stability Index

Every available InSpec resource will indicate its stability. As InSpec matures, certain parts are more reliable than others. Brand new features are likely to be redesigned and marked as such.

The stability indices are as follows:

  • Stability: Deprecated - This features will be removed in future versions, because its known for being problematic. Do not rely on it.
  • Stability: Experimental - New features may change or are removed in future versions
  • Stability: Stable - API is well established and proofed. Maintaining compatibility is a high priority
  • Stability: Locked - Only security and performance fixes are allowed