Structure of YDB documentation subject directories
Introduction
Documentation articles are arranged in a hierarchical structure of subject directories. A subject directory combines a set of articles on a certain general topic.
A topic description includes:
- The target audience of the article. The audience depends on the role of a potential reader when working with YDB, with the following three basic audiences:
- Developer of applications for YDB
- YDB administrator
- YDB developer/contributor
- Purpose: The reader’s task or problem the solution of which is described in the content.
In general, the directory structure directly affects the structure of the documentation table of contents. Typical exceptions are:
- Intermediate stages of documentation creation. A new directory is created immediately to preserve the referential integrity in the future, but its content is still insufficient to be designed as a separate submenu in the table of contents. In this case, articles can be temporarily included in existing submenus.
- Historically established directories whose transfer is undesirable due to the loss of referential integrity.
Level 1 structure
The following subject directories are placed on level 1:
Name | Audience | Purpose |
---|---|---|
getting_started | All | Provide quick solutions to standard problems that arise when starting to work with a new database: what is it, how to install it, how to connect, how to perform elementary operations with data, where to go further in the documentation and on what issues. |
concepts | Application developer | Describe the main structural components of YDB that one will deal with when developing applications for YDB. Provide an insight into the role of each of these components in developing applications. Provide detailed information about component configuration options available to application developers. |
reference, yql | Application developer | A reference guide for daily use on tools for accessing YDB functions: CLI, YQL, and SDK |
best_practices | Application developer | Common approaches to addressing the main challenges that arise when developing applications |
troubleshooting | ? | Tools for identifying the cause of issues |
how_to_edit_docs | Developers YDB | How to update the YDB documentation |
deploy | All | Deploying and configuring YDB databases and clusters. Cloud, orchestrated, and manual deployments. |
maintenance | All | How to maintain YDB databases and clusters: backups, monitoring, logs, and disk swap. |
faq | All | Questions and answers |