Todo List
Critical Priority
- Confirm the site’s primary purpose and target audience.
- Review all public pages for broken internal links.
- Verify the production build runs without errors.
- Check that the homepage has a clear title and description.
- Validate mobile layout on common viewport sizes.
- Audit navigation links for accuracy and consistency.
- Confirm contact or profile links point to the correct destinations.
- Review
_config.ymlfor accurate site metadata. - Ensure generated
_siteoutput is excluded from source changes when appropriate. - Check that no secrets, tokens, or private credentials are committed.
High Priority
- Update the README with local setup instructions.
- Document the deployment workflow.
- Add or verify favicon and web app metadata.
- Review image sizes and compress large assets.
- Confirm page titles are unique and descriptive.
- Add meta descriptions for important pages.
- Improve accessibility labels for navigation and interactive elements.
- Check color contrast across the site.
- Verify blog post dates and archive ordering.
- Review project descriptions for clarity and current status.
- Add missing alt text for images.
- Test the site with JavaScript disabled where practical.
- Confirm comment system setup documentation is current.
- Review external links and remove dead references.
- Add a basic contribution or maintenance note.
Medium Priority
- Standardize Markdown heading levels across docs and posts.
- Add a content style guide for future posts.
- Create a checklist for publishing new blog posts.
- Review tag usage and consolidate duplicates.
- Add screenshots or previews for featured projects.
- Improve archive page readability.
- Add structured data where useful.
- Review Sass organization and remove unused styles.
- Check browser compatibility for key layouts.
- Add a lightweight performance budget.
- Create a changelog or maintenance log.
- Review 404 page content and navigation options.
- Add documentation for asset naming conventions.
- Confirm timezone assumptions for dated content.
- Review GitHub Actions or deployment automation if present.
Low Priority
- Add optional dark mode notes or design exploration.
- Create a backlog for future visual refinements.
- Add examples to documentation where setup steps are ambiguous.
- Review typography scale for consistency.
- Add social preview images for key pages.
- Document how to add a new project entry.
- Review old posts for outdated references.
- Add a glossary for project-specific terms if needed.
- Consider adding an RSS or feed link to navigation.
- Schedule a recurring quarterly site review.