summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/network/dev_guide/index.rst
blob: 5f0e7924ec0e392cdc73ca61e5da729f698a9224 (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
.. _network_developer_guide:

**********************************
Network Developer Guide
**********************************

Welcome to the Developer Guide for Ansible Network Automation!

**Who should use this guide?**

If you want to extend Ansible for Network Automation by creating a module or plugin, this guide is for you. This guide is specific to networking. You should already be familiar with how to create, test, and document modules and plugins, as well as the prerequisites for getting your module or plugin accepted into the main Ansible repository.  See the  :ref:`developer_guide` for details. Before you proceed, please read:

* How  to :ref:`add a custom plugin or module locally <developing_locally>`.
* How to figure out if :ref:`developing a module is the right approach <module_dev_should_you>` for my use case.
* How to :ref:`set up my Python development environment <environment_setup>`.
* How to :ref:`get started writing a module <developing_modules_general>`.


Find the network developer task that best describes what you want to do:

   * I want to :ref:`develop a network resource module <developing_resource_modules>`.
   * I want to :ref:`develop a network connection plugin <developing_plugins_network>`.
   * I want to :ref:`document my set of modules for a network platform <documenting_modules_network>`.

If you prefer to read the entire guide, here's a list of the pages in order.

.. toctree::
  :maxdepth: 1

  developing_resource_modules_network
  developing_plugins_network
  documenting_modules_network