...
- Migrate and Review (April)
- Transfer all existing articles, images, and associated files from GitHub to Confluence
- Copy edit articles for consistent grammar, spelling, formatting, broken links, and any artifacts from GH/Jekyll
- Ensure articles adhere to style/formatting guidelines
- Resize images where needed
- Stage the new site and invite stakeholders to review for issues/bugs
- Set up process workflows (late April/early May)
- In Confluence, define contribution workflows and write SOPs for contributors, beta test SOPs with a pilot group (ideally 1-2 reps each from Governance, Engineering, Design, Research)
- Copy style guide from GitHub README to Confluence, add guidelines for article types/templates
- Set up Jira project for Synapse docs, decide on stages/labels/required fields
- Sync existing GH issues to a Jira backlog
- Establish Confluence page templates for new docs (e.g. concept, procedure, reference, troubleshooting)
- Create a process for external users to file new issues in Jira queue -- either GH issues linked to Jira for now (workaround) or Jira Service Management or similar
...