Improve 'Declaring a PCL' section for clarity

Marin Jankovskirequested to merge
mj/pcl-declaring-improvements into main

Summary

This MR improves the "Declaring a PCL" section to make it clearer and easier to follow.

Changes

Restructured the "Declaring a PCL" section with:

  1. Added introductory context - explains upfront that PCLs can be planned or emergency, and references the Recent PCLs table for recurring events

  2. Converted roles to a table - easier to scan and understand at a glance

  3. Split into two distinct workflows:

    • Declaring a planned PCL - for recurring holidays with 4 clear steps
    • Declaring an emergency PCL - for unexpected situations with streamlined process

  4. Added explicit ownership - each step clearly indicates which team is responsible (in parentheses)

  5. Included cleanup steps - explicitly documents what to do after the PCL ends (step 4 in planned PCL)

  6. Better organization - numbered steps with clear phases and actions

Benefits

  • Easier to follow - clear distinction between planned and emergency workflows
  • Reduced confusion - roles and responsibilities in scannable table format
  • Complete process - includes cleanup steps that were previously missing
  • Better context - readers immediately understand when to use which workflow
  • Actionable - each step has clear ownership and specific actions

Related

Follows up on the recurring PCL entries added in !17085 (merged)

Merge request reports