Hello Carlos,

welcome to the documentation team

Am 03.05.26 um 05:24 schrieb Carlos Peralta:
​Hi everyone,
​As a new user getting involved in the project, I have been thinking about
how the documentation is presented. I would like to share an idea for
structuring it into three main sections to make it more intuitive,
especially for newcomers.
​Here is what I have in mind:
​1. Users Section
This would be the starting point for anyone installing Debian. It could
cover:
​Installation: Step-by-step guides for both GUI and CLI (Command Line
Interface). A key addition would be explaining exactly what each command
does during the CLI installation.
​System Management: Basic commands for updating the system,
downloading/installing software, and how to properly add proprietary
(non-free) software.
​Terminal Basics: A brief guide on how to navigate the terminal.
​2. Developers Section
This section would dive into the technical side of the OS:
​Deep dive documentation into the Debian codebase.
​A comprehensive guide on how to create a custom distribution based on
Debian.
​3. Volunteers / Contributors Section
A dedicated space to organize the community effort:
​A clear breakdown of the different areas that currently need help.
​An explanation of what each area does and how to execute the tasks
required.
​Clear instructions or a sign-up process for those who want to support a
specific team.
​I understand Debian already has a massive amount of documentation, but I
thought a unified structure like this could make the learning curve much
smoother.
​I would love to hear your thoughts on this approach or if there is already
an ongoing effort similar to this that I can help with!
One start point to work on documentation is our wiki (wiki.debian.org)

You can start there to collect the documentation and we can discuss and improve it.

Kind regards

--
Mechtilde Stehmann
## Debian Developer
## PGP encryption welcome
## F0E3 7F3D C87A 4998 2899  39E7 F287 7BBA 141A AD7F

Attachment: OpenPGP_signature.asc
Description: OpenPGP digital signature

Reply via email to