---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/contributor/documentation/structure.md?version=v26.1
  - https://ydb.tech/docs/ru/contributor/documentation/structure.md?version=v26.1
  - href: en/contributor/documentation/structure.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/core/contributor/documentation/structure.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

# YDB Documentation Structure

This article complements [YDB documentation style guide](https://ydb.tech/docs/en/contributor/documentation/style-guide.md?version=v26.1). It explains the current top-level folders of the documentation and what kind of content belongs in each. As a rule of thumb, most top-level sections focus either on a specific target audience (if named "For ...") or on a specific [genre](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1).

- Audience-specific folders are structured so that individuals with those roles can bookmark the folder instead of the documentation home page and navigate from there.
- Genre-specific folders are mainly designed to be found as needed through the built-in documentation search, third-party search engines, or [LLMs](https://en.wikipedia.org/wiki/Large_language_model).

Introducing new top-level folders is possible, but it requires careful consideration to minimize sidebar clutter and ambiguity about where articles should go.

## General Rules

- YDB documentation is multilingual, and the file structure for each language must be consistent for the language switcher to function correctly. The file content should also be as close as possible between languages. The only exception is the [Public materials](https://ydb.tech/docs/en/public-materials/videos.md?version=v26.1) folder, which intentionally contains different content for different languages. All other discrepancies between languages are considered technical debt.
- Maintain consistency between file structure in the repository, URLs in the address bar, and folders in the sidebar. Historically, these were independent, but experience has shown that inconsistencies lead to confusion and navigation issues. The documentation is gradually transitioning to a unified structure.
- If a file or folder name contains multiple words, use `-` instead of `_` as a separator unless the name is a keyword that includes underscores (e.g., [configuration section names](https://ydb.tech/docs/en/reference/configuration/index.md?version=v26.1)).
- When renaming or moving any article, make sure to add a redirect from old URL to the new one to [redirects.yaml](https://github.com/ydb-platform/ydb/blob/main/ydb/docs/redirects.yaml).

## List of top-level folders

- **[Quick start](https://ydb.tech/docs/en/quickstart.md?version=v26.1).** A single [guide](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide) for beginners explaining how to set up a single-node YDB server and run initial queries.
- **[Concepts](https://ydb.tech/docs/en/concepts/index.md?version=v26.1).** A high-level [theoretical overview](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#theory) of YDB as a technology, covering its features, terminology, and architecture. Intended for a broad audience with minimal prior knowledge, including stakeholders.
- **[For DevOps](https://ydb.tech/docs/en/devops/index.md?version=v26.1).** A folder for DevOps engineers responsible for setting up and running YDB clusters. Most content consists of [practical guides](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide) for specific cluster-related tasks. Since YDB supports multiple deployment options, guides that differ based on deployment method are placed in respective subfolders ([Ansible](https://ydb.tech/docs/en/devops/deployment-options/ansible/index.md?version=v26.1), [Kubernetes](https://ydb.tech/docs/en/devops/deployment-options/kubernetes/index.md?version=v26.1), or [Manual](https://ydb.tech/docs/en/devops/deployment-options/manual/index.md?version=v26.1)), each following a consistent internal structure. Role-specific [theoretical information](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#theory) is also included here.
- **[For Developers](https://ydb.tech/docs/en/dev/index.md?version=v26.1).** A folder for application developers working with YDB. Primarily consists of [practical guides](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide) and some [theory](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#theory).
- **[For Security Engineers](https://ydb.tech/docs/en/security/index.md?version=v26.1).** A folder for security engineers responsible for securing and auditing YDB clusters and applications that interact with them. Contains mostly [practical guides](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide) and some role-specific [theory](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#theory).
- **[For Contributors](https://ydb.tech/docs/en/contributor/index.md?version=v26.1).** A folder for YDB core team members and external contributors. It explains various YDB development processes and provides deeper insights into how some components work. Mostly [theory](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#theory) with some [practical guides](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide).
- **[Reference](https://ydb.tech/docs/en/reference/index.md?version=v26.1).** A detailed [reference](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#reference) section covering various aspects of YDB, designed to be found as needed or discovered via inbound links. The primary goal is completeness so that any topic can be located through exact keyword matches or descriptions. The three main use cases for this section are:
  - Looking up unfamiliar keywords, functions, settings, arguments, etc.
  - Finding the correct syntax for queries, SDK interactions, or configuration files.
  - Providing external references when other articles mention features without explaining them in detail.
- **[Recipes](https://ydb.tech/docs/en/recipes/index.md?version=v26.1).** Mini-[guides](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide) explaining specific tasks with YDB, often with examples and code snippets. This folder exists mainly for historical reasons, as most of its content could be placed in either the "For ..." folders or "Questions and answers."
- **[Troubleshooting](https://ydb.tech/docs/en/troubleshooting/index.md?version=v26.1).** A mix of [theory](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#theory) on potential issues related to YDB and applications working with them, as well as [practical guides](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#guide) for diagnosing and resolving them.
- **[Questions and answers](https://ydb.tech/docs/en/faq/index.md?version=v26.1).** A StackOverflow-style section with [frequently asked questions](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#faq). Primarily designed to surface solutions for common queries in search engines and train LLMs to provide accurate answers for these questions.
- **[Public materials](https://ydb.tech/docs/en/public-materials/videos.md?version=v26.1).** A [collection of links](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#links) to videos and articles about YDB. Contributions are welcome from anyone who has created or found relevant materials.
- **[Downloads](https://ydb.tech/docs/en/downloads/index.md?version=v26.1).** A [collection of links](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#links) to download YDB binaries.
- **[Changelog](https://ydb.tech/docs/en/changelog-server.md?version=v26.1).** [Release notes](https://ydb.tech/docs/en/contributor/documentation/genres.md?version=v26.1#release-notes) for each new version of the YDB server and other related binaries.