Doc update notification, doc history and diff view

I monitor changes in the following document (in addition to subscribe the blog) to follow latest change from Let’s Encrypt:

Currently I have to rely on website monitor tools like visualping.io. It works but not ideal for me due to the limitation of their free plan, and the nature of pull instead of push.

I wish I could receive notification from Let’s Encrypt, when a document page I interested in was updated.

Realtime doc change notification could be accomplished in many ways:

  • add rss/atom feed per-page, trigger WebSub for realtime notification
  • create a dedicated opt-in email listing and post all doc changes there, people could filter as wish
  • create a dedicated forum category and post all doc changes there, people could watch threads as wish

I also wish I could view old versions of any document page and compare differences between versions. I am aware of the Policy and Legal Repository, but it’s rather limited and does not provide a diff view.

Doc history and diff view could be accomplished in many ways:

  • maintain the documents in a Git repo and push it to GitHub/GitLab, people could subscribe rss there and view blame/diff
  • maintain the documents in a wiki (Mediawiki/Confluence/etc.) and provide public read-only view, wiki software has nice built-in diff view

These are mostly (all?) on github so as an option you can use the "Watch" feature of github to get notified when anything changes (and see the diff). GitHub - letsencrypt/website: Let's Encrypt Website and Documentation

8 Likes

Thank you for pointing me to the right place!

Now I subscribed Recent Commits to website:main which is slightly better than watch the whole repo.

5 Likes

Yes, our website is entirely maintained on github.

I think in addition to the atom feeds that GitHub provides, you can also get a email digest of changes on a weekly basis.

5 Likes