From f10807eb4286f2d92d3100e59bfa4b27f89fcd32 Mon Sep 17 00:00:00 2001
From: chouseknecht <chouseknecht@ansible.com>
Date: Wed, 2 Mar 2016 01:54:34 -0500
Subject: [PATCH] Adding docker_network_facts module proposal.

---
 docs/proposals/docker/docker_network_facts.md | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/proposals/docker/docker_network_facts.md

diff --git a/docs/proposals/docker/docker_network_facts.md b/docs/proposals/docker/docker_network_facts.md
new file mode 100644
index 00000000000..84576049ba1
--- /dev/null
+++ b/docs/proposals/docker/docker_network_facts.md
@@ -0,0 +1,48 @@
+
+# Docker_Network_Facts Module Proposal
+
+## Purpose and Scope
+
+Docker_network_facts will inspect networks.
+
+Docker_network_facts will use docker-py to communicate with either a local or remote API. It will
+support API versions >= 1.14. API connection details will be handled externally in a shared utility module similar
+to how other cloud modules operate.
+
+## Parameters
+
+Docker_network_facts will accept the parameters listed below. API connection parameters will be part of a shared
+utility module as mentioned above.
+
+```
+name:
+  description:
+    - Network name or list of network names. 
+  default: null
+
+```
+
+
+## Examples
+
+```
+- name: Inspect all networks
+  docker_network_facts
+  register: network_facts
+
+- name: Inspect a specific network and format the output
+  docker_network_facts
+    name: web_app
+  register: web_app_facts
+```
+
+# Returns
+
+```
+{
+   changed: False
+   failed: False
+   rc: 0
+   results: [ < inspection output > ]
+}
+```