diff --git a/docs/index.html b/docs/index.html
index ada8c771..b895898b 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -52,6 +52,7 @@
                 <li><a href="#themes" class="secondary">Themes</a></li>
                 <li><a href="#customization" class="secondary">Customization</a></li>
                 <li><a href="#classless" class="secondary">Class-less version</a></li>
+                <li><a href="#rtl" class="secondary">RTL</a></li>
               </ul>
             </details>
             <details open>
@@ -310,6 +311,22 @@
 
           </section><!-- ./ Docs: Classless -->
 
+          <!-- Docs: RTL -->
+          <section id="rtl">
+            <hgroup>
+              <h2>RTL</h2>
+              <h3>Support for right-to-left text in Pico.</h3>
+            </hgroup>
+            <p>To enable RTL in Pico you need to set <code><i>dir</i>=<u>"rtl"</u></code>on the <code>&lt;<b>html</b>&lt;</html></code> element.</p>
+
+<pre><code><em>&lt;!doctype html&gt;</em>
+&lt;<b>html</b> <i>dir</i>=<u>"rtl"</u> <i>lang</i>=<u>"ar"</u>&gt;
+  <em>...</em>
+&lt;/<b>html</b>&gt;</code></pre>
+
+            <p>The RTL feature is still experimental and will probably evolve.</p>
+          </section><!-- ./ Docs: RTL -->
+
           <!-- Docs: Container -->
           <section id="containers">
             <hgroup>