Project

General

Profile

Actions

User story #8173

closed

Change paragraph order in Documentation

Added by Vincent MEMBRÉ almost 8 years ago. Updated almost 7 years ago.

Status:
Rejected
Priority:
N/A
Category:
Documentation
Target version:
UX impact:
Suggestion strength:
User visibility:
Effort required:
Name check:
Fix check:
Regression:

Description

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


Subtasks 6 (0 open6 closed)

User story #8251: Rewrite the manual introductionReleasedFrançois ARMANDActions
Bug #10668: Broken build after parent ticketReleasedFrançois ARMANDActions
User story #10670: Improve the manual introduction with content from other sourcesReleasedFrançois ARMANDActions
User story #8535: Move the "reference" section at the endReleasedJonathan CLARKE2016-06-15Actions
User story #8536: Remove the usecases from the docRejectedAlexis MoussetActions
User story #8537: Move all administration/exploitation content to a dedicated sectionRejectedAlexis MoussetActions

Related issues 2 (0 open2 closed)

Related to Rudder - User story #10350: Change page split level and reorganize sectionsReleasedFrançois ARMANDActions
Has duplicate Rudder - User story #7707: Reorganize the documentation contentRejectedAlexis Mousset2015-12-30Actions
Actions #1

Updated by François ARMAND almost 8 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.

Actions #2

Updated by Alexis Mousset almost 8 years ago

Actions #3

Updated by Alexis Mousset almost 8 years ago

I think we should reduce the number of top-level entries, and aim at something like:

  • Introduction
    • Features
    • Very high-level overview (data workflow, agent vs. server vs. relay, etc.)
  • Installation
    • Sizing
    • Requirements
    • Server Installation
    • Agent Installation
    • Relay Installation
  • Upgrade
    • Upgrade notes
    • How to
  • Usage
    • Concepts
    • Web Interface
    • Nodes
    • Configuration policies
  • Configuration management
    • Organize your policies
    • Secutiry considerations
    • Write you own techniques
  • Administration
    • Multiserver
    • Backup
    • Monitoring
    • Migration
  • Troubleshooting
    • Debugging methodology and tools
    • Common issues
  • Reference
    • low-level workflow
    • internal architecture
    • generic methods
    • packages
    • man pages
Actions #4

Updated by Alexis Mousset almost 8 years ago

  • Status changed from New to In progress
  • Assignee set to Alexis Mousset
Actions #5

Updated by Vincent MEMBRÉ almost 8 years ago

  • Target version changed from 2.11.21 to 2.11.22
Actions #6

Updated by Vincent MEMBRÉ almost 8 years ago

  • Target version changed from 2.11.22 to 2.11.23
Actions #7

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 2.11.23 to 2.11.24
Actions #8

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 2.11.24 to 308
Actions #9

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 308 to 3.1.14
Actions #10

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 3.1.14 to 3.1.15
Actions #11

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 3.1.15 to 3.1.16
Actions #12

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 3.1.16 to 3.1.17
Actions #13

Updated by Vincent MEMBRÉ over 7 years ago

  • Target version changed from 3.1.17 to 3.1.18
Actions #14

Updated by Vincent MEMBRÉ about 7 years ago

  • Target version changed from 3.1.18 to 3.1.19
Actions #15

Updated by Alexis Mousset about 7 years ago

  • Related to User story #10350: Change page split level and reorganize sections added
Actions #16

Updated by Vincent MEMBRÉ almost 7 years ago

  • Target version changed from 3.1.19 to 3.1.20
Actions #17

Updated by Vincent MEMBRÉ almost 7 years ago

  • Target version changed from 3.1.20 to 3.1.21
Actions #18

Updated by Alexis Mousset almost 7 years ago

  • Status changed from In progress to Rejected

This has been done in subtasks, closing.

Actions

Also available in: Atom PDF