summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/scenario_guides/scenario_template.rst
blob: 14695bed648c47670af025835e144bf0bb591dee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
:orphan:

.. _scenario_template:

*************************************
Sample scenario for Ansible platforms
*************************************

*Use this ``rst`` file as a starting point to create a scenario guide for your platform. The sections below are suggestions on what should be in a scenario guide.*

Introductory paragraph.

.. contents::
   :local:

Prerequisites
=============

Describe the requirements and assumptions for this scenario. This should include applicable subsections for hardware, software, and any other caveats to using the scenarios in this guide.

Credentials and authenticating
==============================

Describe credential requirements and how to authenticate to this platform.

Using dynamic inventory
=========================

If applicable, describe how to use a dynamic inventory plugin for this platform.


Example description
===================

Description and code here.  Change the section header to something descriptive about this example, such as "Renaming a virtual machine".  The goal is that this is the text someone would search for to find your example.


Example output
--------------

What the user should expect to see.


Troubleshooting
---------------

What to look for if it breaks.


Conclusion and where to go next
===============================

Recap of important points. For more information please see: links.