Organize into User Guide (#595)

Author: jarrodmillman

doc/config.yaml

@@ -29,10 +29,10 @@ params:
     title: Scientific Python Theme
     image: logo.svg
     buttontext: Get Started
-    buttonlink: /getstarted/
+    buttonlink: /user_guide/getstarted/
   navbar:
-    - title: Features
-      url: /features/
+    - title: User Guide
+      url: /user_guide/
     - title: Shortcodes
       url: /shortcodes/
     - title: Examples

doc/content/user_guide/_index.md

@@ -0,0 +1,20 @@
+---
+title: "User Guide"
+shortcutDepth: 2
+---
+
+You can configure the behavior, look, and feel of the theme in many ways.
+The remaining pages in the user guide cover various ways of doing so.
+
+{{< admonition danger >}}
+This theme is still under active development, and we make no promises about the
+stability of any specific HTML structure, CSS variables, etc. Make these
+customizations at your own risk, and pin versions if you’re worried about
+breaking changes!
+{{< /admonition >}}
+
+There are a number of options for configuring your site’s look and feel.
+
+- [Get Started](/user_guide/getstarted)
+- [Features](/user_guide/features)
+- [Web Components](/user_guide/web-components)

doc/content/features.md doc/content/user_guide/features.mddoc/content/features.md renamed to doc/content/user_guide/features.md

@@ -95,10 +95,12 @@ practices for native button components such as using the correct [ARIA
 attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/button_role).
 {{< /admonition >}}
 
+<!-- FIXME
 If in your site\'s [custom CSS file](custom-css) you override the [CSS
 custom properties](css-variables) `--pst-color-*` (where `*` is one of
 the semantic color names, such as `primary`, `danger`), badges and
 buttons will automatically use the custom color.
+-->
 
 ## Cards