docs: add note about partials on Create doc page (#5543)

facebook · Sep 11, 2021 · 9a089d4 · 9a089d4
1 parent 453d9c0
commit 9a089d4
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/website/docs/guides/docs/docs-create-doc.mdx b/website/docs/guides/docs/docs-create-doc.mdx
@@ -84,6 +84,14 @@ With <code>{#custom-id}</code> syntax you can set your own header id.
 </BrowserWindow>
 ```
 
+:::note
+
+All files prefixed with an underscore (`_`) under the `docs` directory are treated as "partial" pages and will be ignored by default.
+
+Read more about [importing partial pages](../markdown-features/markdown-features-react.mdx#importing-markdown).
+
+:::
+
 ## Doc tags {#doc-tags}
 
 Optionally, you can add tags to your doc pages, which introduces another dimension of categorization in addition to the [docs sidebar](./sidebar.md). Tags are passed in the front matter as a list of labels: