Project

General

Profile

Actions
Copy link

Architecture #13162

closed

Architecture #12907: Build a centralized place for doc: docs.rudder.io

Redo page split

Added by Alexis Mousset over 5 years ago. Updated over 5 years ago.

Status:
Released
Priority:
N/A
Assignee:
François ARMAND
Category:
Documentation
Target version:
5.0.0~beta1
Pull Request:
https://github.com/Normation/rudder-d...
Effort required:
Name check:
Fix check:
Regression:

Description

Current split is not good, and we can't fix it without preventing easy upmerging.

We will:

  • concatenante all .adoc sources in the right order
  • Split page title level like webhelp does
  • Reset title level in each page to match antora practice
  • Generate files by title hierarchy, using titles slugs
  • Generate redirect map for old doc (without hierarchy) to the new one
  • Try to allow redirecting the other way (to old docs)

Then use the result as build source for reference manual.

Related issues 1 (0 open — 1 closed)

Related to Rudder - Bug #13055: Avoid "Untitled" in page title RejectedAlexis MoussetActions
Actions
Copy link
 #1

Updated by Alexis Mousset over 5 years ago

  • Related to Bug #13055: Avoid "Untitled" in page title added
Actions
Copy link
 #2

Updated by Alexis Mousset over 5 years ago

Internal links would not work...

Actions
Copy link
 #3

Updated by Alexis Mousset over 5 years ago

  • Subject changed from Generate the same page split than in old doc for easy mapping to Redo page split

We will split the content differently.

Actions
Copy link
 #4

Updated by Alexis Mousset over 5 years ago

  • Status changed from New to In progress
Actions
Copy link
 #12

Updated by Alexis Mousset over 5 years ago

  • Status changed from In progress to Pending technical review
  • Assignee changed from Alexis Mousset to François ARMAND
  • Pull Request set to https://github.com/Normation/rudder-doc/pull/484
Actions
Copy link
 #13

Updated by Vincent MEMBRÉ over 5 years ago

  • Target version changed from 5.0.0~beta1 to 5.0.0~beta2
Actions
Copy link
 #14

Updated by Alexis Mousset over 5 years ago

  • Status changed from Pending technical review to Pending release
Actions
Copy link
 #15

Updated by Vincent MEMBRÉ over 5 years ago

  • Target version changed from 5.0.0~beta2 to 5.0.0~beta1
Actions
Copy link
 #16

Updated by Vincent MEMBRÉ over 5 years ago

  • Status changed from Pending release to Released
This bug has been fixed in Rudder 5.0.0~beta1 which was released today. 
Changelog
Actions
Copy link

Also available in: Atom PDF