Merge pull request #130 from tssurya/remove-user-story-folder

Remove user story folder

Author: k8s-ci-robot

docs/userstories/README.md

@@ -13,14 +13,39 @@
 
 ## Non-Goals
 
-(What is out of scope for this proposal.)
+(What is explicitly out of scope for this proposal.)
 
 ## Introduction
 
 (Can link to external doc -- but we should bias towards copying
 the content into the NPEP as online documents are easier to lose
 -- e.g. owner messes up the permissions, accidental deletion)
 
+## User-Stories/Use-Cases
+
+(What new user-stories/use-cases does this proposal introduce?)
+
+A user story should typically have a summary structured this way:
+
+1. **As a** [user concerned by the story]
+2. **I want** [goal of the story]
+3. **so that** [reason for the story]
+
+The “so that” part is optional if more details are provided in the description.
+A story can also be supplemented with examples, diagrams, or additional notes.
+
+e.g
+
+Story 1: Deny traffic at a cluster level
+
+As a cluster admin, I want to apply non-overridable deny rules to certain pod(s)
+and(or) Namespace(s) that isolate the selected resources from all other cluster
+internal traffic.
+
+For Example: The admin wishes to protect a sensitive namespace by applying an
+AdminNetworkPolicy which denies ingress from all other in-cluster resources
+for all ports and protocols.
+
 ## API
 
 (... details, can point to PR with changes)