docs: Edit FEATURE.yaml files so they can be published

Type: docs
Signed-off-by: John DeNisco <jdenisco@cisco.com>
Change-Id: I7280e5c5ad10a66c0787a5282291a2ef000bff5f

src/plugins/abf/FEATURE.yaml

@@ -15,6 +15,6 @@ features:
   - ABF runs as an input feature in the L3 path
 
 
-description: "ACL Based Forwarding"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/builtinurl/FEATURE.yaml

@@ -1,9 +1,9 @@
 ---
-name: Builtin URL support for the static http/https server (builtinurl)
+name: Builtin URL support for the static http or https server
 maintainer: Dave Barach <dave@barachs.net>
 features:
   - Builtin URLs for the static http/https server
-description: "Adds a set of URLs to the static http/https server.
+description: "The (builtinurl) plugin adds a set of URLs to the static http/https server.
               Current URLs, all of which return data in .json fmt:
               <root-url>/version.json - vpp version info
               <root-url>/interface_list.json - list of interfaces

src/plugins/crypto_ia32/FEATURE.yaml

@@ -5,6 +5,6 @@ features:
   - CBC(128, 192, 256)
   - GCM(128, 192, 256)
 
-description: "native crypto-engine"
+description: "An implentation of a native crypto-engine"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/crypto_ipsecmb/FEATURE.yaml

@@ -6,6 +6,6 @@ features:
   - CBC(128, 192, 256)
   - GCM(128, 192, 256)
 
-description: "IPSecMB crypto-engine"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/crypto_openssl/FEATURE.yaml

@@ -9,6 +9,6 @@ features:
   - DES, 3DES
   - MD5
 
-description: "openssl crypto-engine"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/dhcp/FEATURE.yaml

@@ -1,11 +1,11 @@
 ---
-name: Dynamic Host Configuration Protocol (DHCP)
+name: Dynamic Host Configuration Protocol
 maintainer: Dave Barach <dave@barachs.net>, Neale Ranns <nranns@cisco.com>
 features:
   - DHCP client (v4/v6)
   - DHCPv6 prefix delegation
   - DHCP Proxy / Option 82
 
-description: "DHCP client"
+description: "An implemenation of the Dynamic Host Configuration Protocol (DHCP) client"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/gtpu/FEATURE.yaml

@@ -1,10 +1,10 @@
 ---
-name: GTPU
+name: GPRS Tunneling Protocol
 maintainer: Hongjun Ni <hongjun.ni@intel.com>
 features:
   - GTPU decapsulation
   - GTPU encapsulation
 
-description: "GPRS Tunnelling Protocol"
+description: "An implementation of the GPRS Tunnelling Protocol"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/http_static/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: Static http/https server (http_static)
+name: Static http https server
 maintainer: Dave Barach <dave@barachs.net>
 features:
   - An extensible static http/https server with caching

src/plugins/igmp/FEATURE.yaml

@@ -4,6 +4,6 @@ maintainer: Neale Ranns <nranns@cisco.com>
 features:
   - IGMPv3 only.
 
-description: "IGMP"
+description: "An implementation of the Internet Group Management Protocol (IGMP)"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/l3xc/FEATURE.yaml

@@ -8,6 +8,6 @@ features:
     and adding a default route with the same path. However, the L3XC is more
     efficient in memory and CPU
 
-description: "L3-xconnect"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/lacp/FEATURE.yaml

@@ -1,8 +1,8 @@
 ---
-name: Link Aggregation Control Protocol (LACP)
+name: Link Aggregation Control Protocol
 maintainer: Steven Luong <sluong@cisco.com>
 features:
   - Support LACP version 1 specification including marker protocol
-description: "Link Aggregation Control Protocol implementation"
+description: "Link Aggregation Control Protocol implementation (LACP)"
 state: production
 properties: [API, CLI, STATS, MULTITHREAD]

src/plugins/lb/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: LB
+name: Load Balancer
 maintainer: Pfister <ppfister@cisco.com>, Hongjun Ni <hongjun.ni@intel.com>
 features:
   - GRE tunnel mode
@@ -8,6 +8,6 @@ features:
   - Consistent Hash
   - Connection Track
 
-description: "Load Balancer"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/plugins/mactime/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: Time-range-based MAC-address filter (mactime)
+name: Time-range-based MAC-address filter
 maintainer: Dave Barach <dave@barachs.net>
 features:
   - Static / time-range / data quota based MAC address filter

src/plugins/map/FEATURE.yaml

@@ -1,12 +1,12 @@
 ---
-name: Mapping of Address and Port (MAP)
+name: Mapping of Address and Port
 maintainer: Ole Troan <ot@cisco.com>
 features:
   - LW46 BR (RFC7596):
       - Fragmentation and Reassembly
   - MAP-E BR (RFC7597)
   - MAP-T BR (RFC7599)
-description: "IPv4 as a service mechanisms. Tunnel or translate
+description: "Mapping of Address and Port (MAP): IPv4 as a service mechanisms. Tunnel or translate
               an IPv4 address, an IPv4 subnet or a shared IPv4 address.
               In shared IPv4 address mode, only UDP, TCP and restricted
               ICMP is supported."

src/plugins/mdata/FEATURE.yaml

@@ -1,11 +1,11 @@
 ---
-name: Buffer Metadata Change Tracker (mdata)
+name: Buffer Metadata Change Tracker
 maintainer: Dave Barach <dave@barachs.net>
 features:
   - Buffer Metadata Change Tracker
 description: |-
-              Buffer Metadata Change Tracker
-              Uses the before / after graph node main loop performance
+              The Buffer Metadata Change Tracker (mdata)
+              uses the before / after graph node main loop performance
               callback hooks to snapshoot buffer metadata, then
               compare and summarize results per-node.
               Answers the question "what buffer metadata does a particular

src/plugins/nat/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: Network Address Translation (NAT)
+name: Network Address Translation
 maintainer:
   - Ole Troan <ot@cisco.com>
   - Filip Varga <fivarga@cisco.com>
@@ -20,8 +20,8 @@ features:
   - NAT66
   - DS-lite
   - 464XLAT
-description: "The NAT plugin offers a multiple address translation functions.
-              These can be used in a raft of different scenarios. CPE, CGN,
-              etc."
+description: "The Network Address Translation (NAT) plugin offers a multiple address
+              translation functions. These can be used in a raft of different
+              scenarios. CPE, CGN, etc."
 state: production
 properties: [API, CLI, STATS, MULTITHREAD]

src/plugins/svs/FEATURE.yaml

@@ -10,6 +10,6 @@ features:
   - Tables are bound to interfaces.
   - SVS runs as an input feature in the L3 path
 
-description: "Source VRF Select"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vcl/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: VPP Comms Library (VCL)
+name: VPP Comms Library
 maintainer: Florin Coras <fcoras@cisco.com>
 features:
   - Abstracts vpp host stack sessions to integer session handles
@@ -16,7 +16,7 @@ features:
       - Applications that are supported work with VCL and implicitly with VPP's
         host stack without any code change
       - It does not support all syscalls and syscall options
-description: "VCL simplifies app interaction with session layer by exposing
-              APIs that are similar to but not POSIX-compliant."
+description: "VPP Comms Library (VCL) simplifies app interaction with session layer
+              by exposing APIs that are similar to but not POSIX-compliant."
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vnet/bfd/FEATURE.yaml

@@ -1,8 +1,8 @@
 ---
-name: Bidirectional Forwarding Detection (BFD)
+name: Bidirectional Forwarding Detection
 maintainer: Klement Sekera <ksekera@cisco.com>
 features:
   - BFD protocol implementation
-description: "Bidirectional Forwarding Detection implementation"
+description: "An implementation of Bidirectional Forwarding Detection (BFD)."
 state: production
 properties: [API, CLI, STATS, MULTITHREAD]

src/vnet/bier/FEATURE.yaml

@@ -7,6 +7,6 @@ features:
   - Encapsulation for Bit Index Explicit Replication (BIER) in MPLS and
     Non-MPLS Networks (https://tools.ietf.org/html/rfc8296)
 
-description: "BIER"
+description: "An implementation of Bit Indexed Explicit Replication (BIER)"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vnet/devices/af_packet/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: host-interface Device (AF_PACKET)
+name: host-interface Device AF_PACKET
 maintainer: Damjan Marion <damarion@cisco.com>
 features:
   - L4 checksum offload

src/vnet/dpo/FEATURE.yaml

@@ -10,6 +10,6 @@ features:
   - DPO graphs can be rooted at any point in the VLIB graph - notable examples
     are L3 FIB lookup, ABF, L3XC.
 
-description: "DPO"
+description: "Data-Plane Objects (DPO)"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vnet/gre/FEATURE.yaml

@@ -8,6 +8,6 @@ features:
   - L2 tunnels
 missing:
   - GRE keys
-description: "GRE"
+description: "An implementation of Generic Routing Encapsulation (GRE)"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vnet/ip-neighbor/FEATURE.yaml

@@ -5,6 +5,6 @@ features:
   - IP protocol independent Database of Neighbours (aka peers)
   - limits on number of peers, recycling and aging
 
-description: "IP-neighbor"
+description: ""
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vnet/ipsec/FEATURE.yaml

@@ -6,6 +6,6 @@ features:
   - Authetication Header (https://tools.ietf.org/html/rfc4302)
   - Encapsulating Security Payload (https://tools.ietf.org/html/rfc4303)
 
-description: "IPSec"
+description: "An implementation of IPSec"
 state: production
 properties: [API, CLI, MULTITHREAD]

src/vnet/l2/FEATURE.yaml

@@ -1,9 +1,9 @@
 ---
-name: Layer 2 Forwarding (L2)
+name: Layer 2 Forwarding
 maintainer: John Lo <loj@cisco.com>
 features:
-  - L2 Cross-connect (xconnect) of two interfaces
-  - L2 Bridging of multiple interfaces in a bridge domain (BD):
+  - Layer 2 (L2) Cross-connect (xconnect) of two interfaces
+  - Layer 2 (L2) Bridging of multiple interfaces in a bridge domain (BD):
       - Forwarding via destination MAC address of packet
       - MAC learning enable/disable on BD or per interface
       - MAC aging with specified aging interval enable/disable

src/vnet/lisp-cp/FEATURE.yaml

@@ -1,5 +1,5 @@
 ---
-name: Locator/ID Separation Protocol (LISP) Control Plane
+name: Locator ID Separation Protocol Control Plane
 maintainer: Florin Coras <fcoras@cisco.com>
 features:
   - ITR, ETR and RTR mode of operation
@@ -9,6 +9,6 @@ features:
   - RLOC-probing
   - Support for Ethernet, IPv4, IPv6 and NSH EIDs (payloads)
   - Map-resolver failover algorithm
-description: "LISP control plane implementation"
+description: "Locator ID Separation Protocol control plane (LISP) implementation"
 state: production
 properties: [API, CLI, STATS, MULTITHREAD]

src/vnet/lisp-gpe/FEATURE.yaml

@@ -1,11 +1,11 @@
 ---
-name: Locator/ID Separation Protocol Generic Protocol Extension (LISP-GPE)
+name: Locator ID Separation Protocol Generic Protocol Extension
 maintainer: Florin Coras <fcoras@cisco.com>
 features:
   - ITR, ETR and RTR modes
   - Support for Ethernet, IPv4, IPv6 and NSH EIDs (payloads)
   - Source/dest forwarding
   - IPv4 and IPv6 RLOCs
-description: "LISP-GPE implementation"
+description: "Locator ID Separation Protocol Generic Protocol Extension (LISP-GPE) implementation"
 state: production
 properties: [API, CLI, STATS, MULTITHREAD]

src/vnet/lldp/FEATURE.yaml

@@ -1,8 +1,8 @@
 ---
-name: Link Layer Discovery Protocol (LLDP)
+name: Link Layer Discovery Protocol
 maintainer: Klement Sekera <ksekera@cisco.com>
 features:
   - link layer discovery protocol implementation
-description: "Link Layer Discovery Protocol implementation"
+description: "Link Layer Discovery Protocol (LLDP) implementation"
 state: production
 properties: [API, CLI, STATS, MULTITHREAD]

src/vnet/mpls/FEATURE.yaml

@@ -5,6 +5,6 @@ features:
   - Label imposition/disposition - pipe and uniform mode
   - Tunnels - unidirectional
 
-description: "MPLS"
+description: "An implementation of Multi-Protocol Label Switching (MPLS)"
 state: production
 properties: [API, CLI, MULTITHREAD]