b3126044e8
- Simplify flatten_vault API to return usize instead of MigrationResult struct - Add KEEP_FOLDERS: attachments/ and _themes/ alongside type/, config/, theme/ - Use HashSet for collision tracking in unique_filename - Update wikilinks from path-based [[folder/slug]] to title-based [[slug]] - Clean up empty directories after flattening - Flatten demo-vault-v2: move all notes from type-based subfolders to root - Update smoke tests for flat vault structure - Remove migrate_to_flat_vault from repair_vault (one-time migration only) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
27 lines
1.9 KiB
Markdown
27 lines
1.9 KiB
Markdown
---
|
|
aliases: ["Migrate newsletter archive to new template"]
|
|
Is A: Task
|
|
Belongs to: "[[25q2]]"
|
|
Status: Done
|
|
Owner: "[[person-luca-rossi]]"
|
|
---
|
|
# Migrate newsletter archive to new template
|
|
|
|
The newsletter archive on the website was using a template designed in early 2023 that no longer matched the current brand identity. The archive is a significant traffic driver (roughly 40% of organic search traffic lands on archive pages), so the template needed to be updated for both aesthetic and functional reasons. The new template introduced better typography, a table of contents for long articles, improved code block rendering, and prominent CTAs for subscribing.
|
|
|
|
The migration involved updating the template, testing it across all 120+ archive pages, and ensuring no SEO regressions from URL changes or broken structured data. [[person-sara-ricci]] reviewed the visual design while [[person-luca-rossi]] handled the technical implementation.
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] Design and implement new archive page template matching current brand guidelines
|
|
- [x] Migrate all 120+ archive pages to the new template
|
|
- [x] Add table of contents, improved code blocks, and subscribe CTAs to the template
|
|
- [x] Verify no broken links, missing images, or SEO regressions after migration
|
|
- [x] Monitor search traffic for 2 weeks post-migration to confirm no negative impact
|
|
|
|
## Notes
|
|
|
|
- The migration went smoothly with no SEO regressions. Organic traffic actually increased by roughly 8% in the two weeks post-migration, likely due to improved page load times and better mobile rendering.
|
|
- The subscribe CTA in the new template generates approximately 200 new subscribers per month from archive traffic -- previously there was no CTA on archive pages at all.
|
|
- [[person-sara-ricci]] caught several formatting issues during the review that would have gone unnoticed, reinforcing the value of having a dedicated editorial eye on technical changes.
|