Improvements

docs/getting-started/index.md

@@ -0,0 +1,14 @@
+# Getting started
+
+To help you get started with uv, we'll cover a few important topics:
+
+- [Installing uv](./installation.md)
+- [First steps after installation](./first-steps.md)
+- [An overview of uv's features](./features.md)
+- [How to get help](./help.md)
+
+Read on, or jump ahead to another section:
+
+- Get going quickly with [guides](../guides/index.md) for common workflows.
+- Learn more about the core [concepts](../concepts/index.md) in uv.
+- Use the [reference](../reference/index.md) documentation to find details about something specific.

docs/reference/index.md

@@ -0,0 +1,11 @@
+# Reference
+
+The reference section provides information about specific parts of uv:
+
+- [Commands](./cli.md): A reference for uv's command line interface.
+- [Settings](./settings.md): A reference for uv's configuration schema.
+- [Resolver](./resolver-internals.md): Details about the internals of uv's resolver.
+- [Versioning](./versioning.md): uv's versioning policy.
+- [Platform support](./platforms.md): uv's supported operating systems and architectures.
+
+Looking for a broader overview? Check out the [concepts](../concepts/index.md) documentation.

docs/stylesheets/extra.css

@@ -126,10 +126,14 @@ See https://github.com/astral-sh/uv/issues/5130 */
   }
 }
 
+
 /* Reducing spacing between nav items to fit more content */
 .md-nav__link {
   margin-top: 0.25em;
 }
+.md-nav__item--section {
+  margin: 0.75em 0;
+}
 /* Retain larger spacing for each top-level section in the nav */
 .md-nav__item--nested {
   margin-top: 0.6em;
@@ -143,6 +147,22 @@ See https://github.com/astral-sh/uv/issues/5130 */
     user-select: none;
 }
 
+/* Increase the size of the sections headings, remove the bold */
+.md-nav__item--section>.md-nav__link {
+  font-size: 16px;
+  font-weight: normal;
+}
+/* Increase the size of the index nav item to match the sections */
+.md-nav__item:first-child {
+  font-size: 16px;
+  font-weight: normal;
+}
+/* But do not increase the size of other nav items */
+.md-nav__item--section > .md-nav > .md-nav__list > .md-nav__item {
+  font-size: 14px;
+  font-weight: normal;
+}
+
 /* Bold the active nav link for accessibility */
 .md-nav__link--active {
   font-weight: bold;

mkdocs.template.yml

@@ -82,6 +82,7 @@ extra:
 nav:
   - Introduction: index.md
   - Getting started:
+      - getting-started/index.md
       - Installation: getting-started/installation.md
       - First steps: getting-started/first-steps.md
       - Features: getting-started/features.md
@@ -122,6 +123,7 @@ nav:
       - Locking environments: pip/compile.md
       - Compatibility with pip: pip/compatibility.md
   - Reference:
+      - reference/index.md
       - Commands: reference/cli.md
       - Settings: reference/settings.md
       - Resolver: reference/resolver-internals.md