diff --git a/README.md b/README.md
index fdd1351..69374f2 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,40 @@ topic_id = 8061
 st_discourse(discourse_url, topic_id)
 ```
 
+## Tutorial
+
+### Embed Streamlit topics into your Streamlit Sharing apps
+
+Let's say you made a topic on this forum showcasing one of your apps.
+Now you want to integrate comments from your topic directly in it.
+
+1. The first step is to get your **Topic ID**.
+    You can find it in the URL of your topic.
+    For instance with this URL: https://discuss.streamlit.io/t/discourse-integration/8061, the Topic ID is 8061, located at the end.
+
+2. Now in your app, you just have to call `st_discourse("discuss.streamlit.io", 8061)`
+
+> :warning: If your app is **not** run from share.streamlit.io, you won't be able to embed comments from discuss.streamlit.io.
+> The same thing applies when you run your app locally, you'll get an `Embedding error`.
+>
+> If your app is not hosted on Streamlit Sharing, please refer to the two next parts below.
+
+### Embed posts from another Discourse into your Streamlit apps
+
+With this component, you can embed comments from other Discourse websites as well.
+However, those other Discourse must be configured to allow embedding for your Streamlit app domain.
+
+For example, if you have a discourse hosted on mydiscourse.example.com, and your streamlit app on myapp.herokuapp.com, you must allow the host myapp.herokuapp.com in your discourse configuration.
+
+For more information, please follow steps 1 to 3 described [here](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963#configuring-discourse-for-embedding-simple-setup).
+
+### Another way to embed comments into your Streamlit apps
+
+Not everyone has its own Discourse, or has admin rights to change embedding settings.
+
+If you're just looking for an easy way to embed comments into your apps **not** hosted on Streamlit Sharing, a great alternative would be to use [Disqus](https://disqus.com/).
+You can easily embed comments using [this component](https://share.streamlit.io/okld/streamlit-gallery/main?p=disqus) ([github](https://github.com/okld/streamlit-disqus)).
+
 ## Demo
 
 [![Open in Streamlit][share_badge]][share_link]