inspec/docs
Clinton Wolfe b3fafab1e6 Add aws_eks_cluster resource (#3582)
* add aws_eks_cluster

Signed-off-by: Timothy van Zadelhoff
timothy.inspec@theothersolution.nl

* disable ABC check on fetch_from_api

Signed-off-by: Timothy van Zadelhoff <timothy.inspec@theothersolution.nl>

* add status predicates

* Change docs for status attribute

Signed-off-by: Timothy van Zadelhoff <timothy.inspec@theothersolution.nl>

*     Add integration tests

    Signed-off-by: Timothy van Zadelhoff <timothy.inspec@theothersolution.nl>

* Adjust EKS build code to almost work

Signed-off-by: Clinton Wolfe <clintoncwolfe@gmail.com>

* EKS only uses private subnets - integration tests pass

Signed-off-by: Clinton Wolfe <clintoncwolfe@gmail.com>

* Correct AWS Exception class for resource search miss in unit test

Signed-off-by: Clinton Wolfe <clintoncwolfe@gmail.com>

* Update unit test to reflect AWS resource-standard miss behavior, returning nil for most properties

Signed-off-by: Clinton Wolfe <clintoncwolfe@gmail.com>
2018-11-27 16:54:47 -05:00
..
dev Minor cleanups of plugin documentation. 'Plugin' instead of 'PluginDefinition' (#3527) 2018-10-18 15:56:04 -04:00
resources Add aws_eks_cluster resource (#3582) 2018-11-27 16:54:47 -05: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 Inspec 3.0 (#3512) 2018-10-15 18:25:27 -04:00
dsl_resource.md docs: Update example resource (#2904) 2018-04-05 08:50:49 -04:00
glossary.md Markdown and code fence fixes (#3230) 2018-07-19 14:31:38 -04:00
habitat.md documents inspec habitat profile setup command (#3559) 2018-11-01 13:47:23 -04:00
inspec_and_friends.md Markdown and code fence fixes (#3230) 2018-07-19 14:31:38 -04:00
matchers.md Correct/Enhance cmp matcher examples (#3537) 2018-10-23 16:02:40 -04:00
migration.md Fix typo in some docs (#2841) 2018-03-20 08:43:30 -04:00
platforms.md Inspec 3.0 (#3512) 2018-10-15 18:25:27 -04:00
plugin_kitchen_inspec.md Markdown and code fence fixes (#3230) 2018-07-19 14:31:38 -04:00
plugins.md Fixes broken link in documentation (#3588) 2018-11-07 15:40:07 -05:00
profiles.md Fix rendering of profiles webpage. (#3393) 2018-09-17 17:41:42 -04:00
README.md Bup the release to test new gem builds (#3071) 2018-05-17 20:05:04 -04:00
reporters.md Update UUID documentation (#3612) 2018-11-15 13:19:37 -05:00
shell.md Add additional links to Learn Chef Rally content (#2477) 2018-03-14 11:01:12 -04:00
style.md Fix rendering and other issues in the Style Guide (#3539) 2018-11-01 13:07:02 -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