Update README.md

README.md

@@ -67,39 +67,55 @@ The perturber is a finetuned BART model (Lewis et al., 2020) with 24 layers, 102
 
 This model release is separately trained using the HuggingFace transformers library, with the same parameters as the ParlAI model.
 
-Currently the perturber supports text rewriting along three axes and several attributes:
-- **gender:** man, woman, non-binary
-- **race:** black, white, asian, hispanic, native-american, pacific-islander
-- **age:** child, young, middle-aged, senior, adult
-
 ### Uses
 
 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
+Below we show some example inputs and outputs for the perturber rewriting text along different demographic axes and attributes.
+
+Model inputs follow the format `[selected_word][target_attribute] <PERT_SEP> [input_text]`, where `selected_word` is a word that contains demographic information, `target_attribute` is a demographic attribute such as "man" or "asian", and `input_text` is the text sequence to rewrite.
 
-Input:
+Currently the perturber supports text rewriting along three axes and several attributes:
+- **gender:** man, woman, non-binary
+- **race:** black, white, asian, hispanic, native-american, pacific-islander
+- **age:** child, young, middle-aged, senior, adult
+ 
+### Gender
+_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.
+_Output:_
+Jackie was passionate about rock climbing and her love for the sport was infectious to all men around her.  
+<br/>
 
-Input:
+_Input:_
 Alice, man <PERT_SEP> To her girlfriend Jen, Alice was a doting mother, loving girlfriend and talented actress.
 
-Output:
+_Output:_
 To his girlfriend Jen, Alan was a doting father, loving partner and talented actor.
-
-Input:
+<br/>
+<br/>
+
+_Input:_
+his, non-binary <PERT_SEP> Jack was passionate about rock climbing and his love for the sport was infectious to all men around him.
+
+_Output:_
+Jack was passionate about rock climbing and their love for the sport was infectious to all men around them.
+<br/>
+<br/>
+### Age
+_Input:_
 child, senior <PERT_SEP> The young child is naive and his innocence must be protected at all costs.
 
-Output:
+_Output:_
 The elderly person is naive and his innocence must be protected at all costs.
 
-Input:
+### Race/Ethnicity
+_Input:_
 Asian, black <PERT_SEP> The Asian students association often hosted anime nights and boba events on campus.
 
-Output:
+_Output:_
 The Black students association often hosted anime nights and boba events on campus.
 
 ### Contributions