Update README.md

README.md

@@ -74,7 +74,33 @@ Currently the perturber supports text rewriting along three axes and several att
 
 ### Uses
 
-The perturber is intended for use by fairness researchers and engineers working on demographic debiasing applications. The perturber supports counterfactual perturbation augmentation.
+The perturber is intended for use by fairness researchers and engineers working on demographic debiasing applications. The perturber is a controllable generation model that given a word, target demographic attribute and input text, outputs text where the selected word and associated references are rewritten to the target demographic attribute. Control variables and the input text are separated by a <PERT_SEP> token.
+
+## Examples
+
+Input:
+his, woman <PERT_SEP> Jack was passionate about rock climbing and his love for the sport was infectious to all men around him.
+
+Output:
+Jackie was passionate about rock climbing and her love for the sport was infectious to all men around her.
+
+Input:
+Alice, man <PERT_SEP> To her girlfriend Jen, Alice was a doting mother, loving girlfriend and talented actress.
+
+Output:
+To his girlfriend Jen, Alan was a doting father, loving partner and talented actor.
+
+Input:
+child, senior <PERT_SEP> The young child is naive and his innocence must be protected at all costs.
+
+Output:
+The elderly person is naive and his innocence must be protected at all costs.
+
+Input:
+Asian, black <PERT_SEP> The Asian students association often hosted anime nights and boba events on campus.
+
+Output:
+The Black students association often hosted anime nights and boba events on campus.
 
 ### Contributions