X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2Fuser-guide.rst;h=e8698194bd3fddcb92d43305f7fdce51dd285bc4;hb=28f25bf36954af95bae5348b19921286673ab1d5;hp=c2988f849c2fae97c022b3a51b4bdc41346264a4;hpb=341a4f87202287269fa08050953e3acf52461d8b;p=netconf.git

diff --git a/docs/user-guide.rst b/docs/user-guide.rst
index c2988f849c..e8698194bd 100644
--- a/docs/user-guide.rst
+++ b/docs/user-guide.rst
@@ -1,5 +1,13 @@
 .. _netconf-user-guide:
 
+.. |ss| raw:: html
+
+   <strike>
+
+.. |se| raw:: html
+
+   </strike>
+
 NETCONF User Guide
 ==================
 
@@ -78,6 +86,20 @@ This guide focuses on using RESTCONF.
      http://localhost:8181/rests/data/network-topology:network-topology?content=nonconfig
      for operational datastore.
 
+    | Also in case of `RFC-8040 <https://tools.ietf.org/html/rfc8040>`__,
+     if a data node in the path expression is a YANG leaf-list or list
+     node, the path segment has to be constructed by having leaf-list or
+     list node name, followed by an "=" character, then followed by the
+     leaf-list or list value. Any reserved characters must be
+     percent-encoded.
+    | e. g. GET
+     http://localhost:8181/rests/data/network-topology:network-topology/topology=topology-netconf?content=config
+     for retrieving data from configuration datastore for
+     topology-netconf value of topology list is equivalent to the deprecated request
+    | |ss| GET |se|
+     http://localhost:8181/restconf/config/network-topology:network-topology/topology/topology-netconf,
+     which is related to `draft-bierman-netconf-restconf-02
+     <https://tools.ietf.org/html/draft-bierman-netconf-restconf-02>`__.