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!
Best regards,
Carlos
