new: Add sidebar and explanation

app.py

@@ -18,31 +18,55 @@ HTML_WRAPPER = """<div style="overflow-x: auto; border: 1px solid #e6e9ef; borde
 
 def render_entities(doc, colors: dict, options: dict) -> str:
     """
-    Takes a SpaCy doc
+    Takes a SpaCy doc and renders the entities with the given colors.
     """
 
-    #if isinstance(doc, spacy.tokens.doc.Doc):
-    #    doc = doc.to_json()
-
     html = spacy.displacy.render(doc, style="ent", options=options)
     html = html.replace("\n", " ")
 
     return html
 
 
-st.header("Location Entity Recognition Demo 🔎🌆🌍")
+st.sidebar.header("Location Recognition Demo 🔎🌆🌍")
+st.sidebar.markdown(
+    """
+This example application accompanies the blog post: [Extracting useful information from documents with Named Entity Recognition]().
+It uses a pre-trained Named Entity Recognition (NER) model from the [spaCy](https://spacy.io/) library to extract locations from your own examples, or a sample of grant applications from The Wellcome Trust.
+The application will extract the following types of location entity:
 
-st.subheader("Look for Locations")
+* __GPE__: Geopolitical entities (countries, cities, states)
+* __LOC__: Locations (mountains, rivers, lakes)
+"""
+)
 
-if st.button("Show new example", key="text"):
-    sample = random.choice(grants)
-    doc = nlp(sample["text"])
+
+def show_example(text):
     html = render_entities(doc, colors, options)
-    text = st.text_area("Text input", value=sample["text"], height=200)
     st.write(HTML_WRAPPER.format(html), unsafe_allow_html=True)
-else:
+
+    return text
+
+
+if st.button("Show Wellcome example", key="text"):
     sample = random.choice(grants)
-    doc = nlp(sample["text"])
-    html = render_entities(doc, colors, options)
-    text = st.text_area("Text input", value=sample["text"], height=200, help="Enter text here and click the 'Find Locations' button to search for entities.")
-    st.write(HTML_WRAPPER.format(html), unsafe_allow_html=True)
+    text = st.text_area(
+        "Add your own text or click the button to see a Wellcome example",
+        value=sample["text"],
+        height=200,
+        help="Enter your own text and press CTRL + ENTER to search for entities",
+    )
+    doc = nlp(text)
+    show_example(doc.text)
+else:
+    text = st.text_area(
+        "Add your own text or click the button to see a Wellcome example",
+        value="Enter your text here",
+        height=200,
+        help="Enter your own text and press CTRL + ENTER to search for entities",
+    )
+    doc = nlp(text)
+    show_example(doc.text)
+
+st.markdown(
+    "Examples from The Wellcome Trust are taken from data that are publishes openly at [360 Giving](https://data.threesixtygiving.org/). They are published under a [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) license."
+)