Roadmap

This is a roadmap for the future of this site. I may never get to some of these ideas, but they were worth writing down. Things I’ve done are recorded at the changelog.

Let me know if you see a broken link or other unexpected behavior at hello@mattwidmann.net.

Content

New pages and content I’d like to add to the site.

• Add more photos and diagrams to notes.

• Add short entries for links I find and projects I’m working on, paginated by month or year.

• Display ratings from books in their index.

• Group note updates on index by date updated.

Bugs

Issues with the site.

• The RSS feed’s publish date causes issues with feed readers.

• If a note with an inbound link doesn’t change, but a new inbound link is added, the incremental build system will not rebuild the linked-to note to reflect the new link.

• Add styling for tables.

Features

Improvements that change how the site is written or viewed.

• Support a list of commonly-used reference-style links in Markdown to avoid needing to constantly repeat them like [Rust]: https://www.rust-lang.org.

• Find a way to have an RSS feed for notes I’m updating. Maybe the RSS feed could be a weekly digest of notes that have changed and by how much, but this would involve some automated publishing process and potentially reviewing version control history.

Enhancements

Minor adjustments that make the site better, but aren’t fixing functional issues.

• Move the date and inbound links to the side of note content.

• Add excerpts for inbound links to notes.

• Add a tombstone to the end of each page.

• Support splitting up notes into multiple Markdown files, concatenated together in lexicographic order.

• Support JSON feeds.

• Use a hierarchical numbering for nested ordered lists, like 1.2.3.

• Add a mailto link to the bottom of updates in the RSS feed.

Internal

Ideas that make it easier for me to work on the site, but don’t affect the HTML output.

• Remove notes from the output directory if they were removed from the source.

• Track server logs to see how often the website is visited.

• Automatically validate the site before publishing:

  • Images should always be sized with alt text or conform to the correct aspect ratio.
  • Ensure each file is valid using W3C’s markup, CSS, or feed validation services.

• Add integration tests.

• Show the time taken to regenerate each file, or the files that corresponded to the longest time.

• Take advantage of additional CPUs when regenerating the site.

• Support splitting notes across multiple files and concatenating them into a single web page.

• Automatically add the date updated to non-note pages.

Experimental

Ideas for features that are low-priority.

• Make it easier to add a temporary banner to the site, as calls to action for contemporary causes, like registering to vote in the U.S. or donating to a charity in need.

• Add color-coded tags to each note, to make it easier to see which section (e.g. plotting, making, garden, or reading) it’s from on the index.

• Add pre-generated mathematical equation typesetting with a tool like KaTeX.

• Add support for short updates interspersed with articles, like tweets but without Twitter.

• Add loading="lazy" to images so they’re only fetched when they would be visible on the page. On the other hand, this can frustrate people who want to load the entire page to read offline.

• Allow Markdown documents to have sidenotes, following in Gwern’s example and Tom Critchlow’s thoughts.

• Check prose for style problems and weasel words.

• Automatically compress source images when building the site.

• Add an email newsletter to make it easier for non-technical readers to follow updates.

• Set up global and per-page bibliographies that can be referenced from articles and notes.

• Store books and other referenced works as JSON5 CSL-JSON Data.

• Add metric conversions to any units found.

• Make an index of all the links on the site, like Jim Nielsen did in Indexing My Blog’s Links.

• Add a date to the footer for when the site was last updated.

• Consider additional distinct link suffixes for media, downloads, and mailto links.

• Include a log of updates to each note using Git commit history.

Updated on 12 September 2021.

What’s already changed is in the changelog. Inspired by Dave Redfern’s roadmap.