uv/docs/concepts/projects/index.md
Zanie Blue ca9aaf1c48
Reorganize the project concept documentation (#9121)
- Adds a collapsible section for the project concept
- Splits the project concept document into several child documents.
- Moves the workspace and dependencies documents to under the project
section
- Adds a mkdocs plugin for redirects, so links to the moved documents
still work

I attempted to make the minimum required changes to the contents of the
documents here. There is a lot of room for improvement on the content of
each new child document. For review purposes, I want to do that work
separately. I'd prefer if the review focused on this structure and idea
rather than the content of the files.

I expect to do this to other documentation pages that would otherwise be
very nested.

The project concept landing page and nav (collapsed by default) looks
like this now:

<img width="1507" alt="Screenshot 2024-11-14 at 11 28 45 AM"
src="https://github.com/user-attachments/assets/88288b09-8463-49d4-84ba-ee27144b62a5">
2024-11-19 13:52:12 -06:00

18 lines
756 B
Markdown

# Projects
Projects help manage Python code spanning multiple files.
!!! tip
Looking for an introduction to creating a project with uv? See the [projects guide](../../guides/projects.md) first.
Working on projects is a core part of the uv experience. Learn more about using projects:
- [Understanding project structure and files](./layout.md)
- [Creating new projects](./init.md)
- [Managing project dependencies](./dependencies.md)
- [Running commands and scripts in a project](./run.md)
- [Using lockfiles and syncing the environment](./sync.md)
- [Configuring the project for advanced use cases](./config.md)
- [Building distributions to publish a project](./build.md)
- [Using workspaces to work on multiple projects at once](./workspaces.md)