@@ -2,12 +2,11 @@ MkDocs ➜ Docusaurus migration checklist
22
33Goal: ship `docusaurus/` as the new production site for https://docs.codacy.com/
44
5- - [ ] **Release process** → see sections 4 and 9
6- - [ ] **Information architecture + sidebar order** → see section 2
7- - [ ] **Theme/branding** → see sections 2 and 7 (owner: Felipe)
8- - [ ] **Production URL parity + internal links** → see sections 1, 3, and 8
9- - [ ] **Markdown/MDX consistency** → see section 1
10- - [ ] **Contributor guidance (README/best practices)** → see section 10
5+ ## 0) Make it beautiful
6+ - [ ] Colors, fonts and sizes
7+ - [ ] Better footer
8+ - [ ] Beautiful navigation
9+ - [ ] Nav links
1110
1211## 1) Content parity (docs rendering)
1312- [ ] Confirm all pages exist in `docusaurus/docs` (count + spot-check key sections)
@@ -55,7 +54,7 @@ MkDocs currently publishes:
5554## 7) Tracking, scripts, and UX widgets
5655MkDocs uses `extra.segment_key`, `extra.user_feedback`, and custom JS/CSS.
5756- [ ] Add tracking (Segment or chosen tool) to Docusaurus
58- - [ ] Add Intercom
57+ - [ ] Add Zendesk
5958- [ ] Re-implement “user feedback” if it was a widget on MkDocs
6059- [ ] Re-implement any “version selector” behavior (MkDocs `assets/javascripts/version-select.js` + CSS)
6160
@@ -77,7 +76,3 @@ MkDocs uses `extra.segment_key`, `extra.user_feedback`, and custom JS/CSS.
7776- [ ] Decide what to do with MkDocs artifacts once cutover is complete:
7877 - [ ] `mkdocs.yml`, `requirements.txt`, MkDocs workflows
7978 - [ ] MkDocs theme submodule `submodules/codacy-mkdocs-material`
80-
81- ## Done
82- - [x] Release notes tabs in navbar/sidebars
83- - [x] Auto last updated
0 commit comments