Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Transition Documentation: QA #16645

Closed
12 of 23 tasks
Tracked by #16859 ...
maortiz-27-80 opened this issue Jan 3, 2024 · 4 comments
Closed
12 of 23 tasks
Tracked by #16859 ...

Transition Documentation: QA #16645

maortiz-27-80 opened this issue Jan 3, 2024 · 4 comments
Assignees
Labels
CMS Team CMS Product team that manages both editor exp and devops Needs refining Issue status

Comments

@maortiz-27-80
Copy link

maortiz-27-80 commented Jan 3, 2024

User Story or Problem Statement

Our primary objective is to facilitate a smooth transition for the incoming CMS team. To achieve this, we need to document our processes comprehensively. This documentation will serve as a valuable resource for the new team members and contribute to the overall success of the handover.

Overall Process Documentation

  • Identify and document end-to-end processes
  • Include step-by-step procedures, key milestones, and dependencies
  • If applicable, identify and document dependencies on external systems, APIs, or third-party services
  • Document the location of critical knowledge repositories, wikis, or documentation sources
  • Include information about access permissions and guidelines for updating or maintaining these repositories
  • Include an updated list of key contacts within the organization, including team leads, support personnel, and any external contacts relevant to the CMS team's responsibilities
  • Document any historical data, insights, or lessons learned from past projects or incidents that may be valuable for the incoming team
  • Document the details of the current environment and infrastructure, including server configurations, network architecture, and any specialized hardware or software in use
  • Provide information about integration points and how different components of the system interact
  • Specify the tools and processes used for monitoring system health
  • Provide details on logging practices, log locations, and how to interpret and respond to common log entries
  • Outline the process for releasing new features, updates, or patches
  • Document versioning practices, release notes, and rollback procedures

Repetitive Processes

  • Identify and document repetitive processes that are crucial for daily operations
  • Include detailed instructions, best practices, and any relevant tools or resources

Acceptance Criteria

  • Document processes in Confluence. Parent page for QA is here.
  • Each documented process should be reviewed and approved by the PO, PM, and DM
  • The documentation should be clear, concise, and easily understandable by individuals with varying levels of expertise
  • Include visual aids, flowcharts, diagrams, and links (external and internal) where applicable to enhance clarity

Team

Please check the team(s) that will do this work.

  • CMS Team
  • Public Websites
  • Facilities
  • Accelerated Publishing

cc: @BerniXiongA6 @EWashb @ndouglas

@maortiz-27-80 maortiz-27-80 added CMS Team CMS Product team that manages both editor exp and devops Needs refining Issue status labels Jan 3, 2024
@maortiz-27-80 maortiz-27-80 changed the title Copy of Transition Documentation: Dev Ops Transition Documentation: QA Jan 3, 2024
@JunTaoLuo
Copy link
Contributor

Hey @BerniXiongA6 @maortiz-27-80, the document is ready for review so feel free to take a look and let me know if there are details you'd like me to add.

@JunTaoLuo
Copy link
Contributor

@maortiz-27-80 @BerniXiongA6 @michelle-dooley @EWashb the QA doc is ready for a look.

@EWashb
Copy link
Contributor

EWashb commented Jan 23, 2024

This is great @JunTaoLuo! Thank you for the thorough write up

@JunTaoLuo
Copy link
Contributor

I'll mark this issue as completed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CMS Team CMS Product team that manages both editor exp and devops Needs refining Issue status
Projects
None yet
Development

No branches or pull requests

3 participants