User story #8173
Change paragraph order in Documentation
While doing #8169, we had the idea to change of the documentation is organized.
First in #8169, We added a section before administration called: "Manage your IT", The goal of this section is to give adivce, best practices and explain how to things in your IT using Rudder.
We added one example how to here, but it more needs to be added. (in another issues!)
But by doing that we were not happy with the current organisation ...
We think "Rudder web interface", "Node Management", "Configuration management" and "Administration" sections should be put together into a section presenting Rudder and not be at the top level making a lighter modification
In fact i think "Rudder web interface", should be renamed to "Rudder" or "Rudder presentation" or "Rudder overview", with the three other section inside
#1 Updated by François ARMAND over 2 years ago
That would be much appreciate. Today, "Configuration Management" at root level is very misleading. As an user, I'm surprised that that chapter don't talk at all about how to actually manage configuration in my system, with examples and hands on and the like.
#3 Updated by Alexis MOUSSET over 2 years ago
I think we should reduce the number of top-level entries, and aim at something like:
- Very high-level overview (data workflow, agent vs. server vs. relay, etc.)
- Server Installation
- Agent Installation
- Relay Installation
- Upgrade notes
- How to
- Web Interface
- Configuration policies
- Configuration management
- Organize your policies
- Secutiry considerations
- Write you own techniques
- Debugging methodology and tools
- Common issues
- low-level workflow
- internal architecture
- generic methods
- man pages