[{"author":"lrivallain","date":"2026-08-18T07:43:49+00:00","message":"Answer conditional requests on the RSS feeds (#34)\n\nA subscribed reader polls the same feed URL every few minutes, forever, and\nthe answer only changes when a new commit lands. Every poll was rebuilding\nand resending an identical document.\n\nThe feeds now carry an ETag, a Last-Modified date and a Cache-Control header,\nand the view answers a matching If-None-Match or If-Modified-Since with an\nempty 304.\n\nFor the ETag to be stable between polls the body has to be reproducible, so\nthe rendering became a pure function of its arguments: feeds no longer reads\nthe Flask request context, and the view passes the feed and logo URLs in.\nThat also makes the serialized body cacheable, keyed on the commits it\npublishes, which removes the repeated rebuild.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: e6778dd0-0b33-4f13-b014-53a54aae7627","sha":"f2d1e69cd25cf60f4c03af4df53fccc8a00c2a13","url":"https://github.com/lrivallain/azure_docs_watcher/commit/f2d1e69cd25cf60f4c03af4df53fccc8a00c2a13"},{"author":"lrivallain","date":"2026-08-18T06:41:16+00:00","message":"Fix the 500 on every commit view and pin the runtime contract\n\n`datetime.UTC` is an alias introduced in Python 3.11. The Azure App Service\nruns Python 3.10, so parsing a commit date raised\n\n    AttributeError: module 'datetime' has no attribute 'UTC'\n\non every request that listed commits. Pages that do not parse a date, the home\npage and the section index, kept working, which is why the failure looked like\nit was limited to one repository.\n\nThe alias was not written by hand: ruff's UP017 rewrote the portable\n`datetime.timezone.utc` into it, because `target-version` claimed 3.13 while\nproduction had 3.10. The CI installed 3.13 too, so nothing ever exercised the\nruntime that actually serves the application.\n\nThree changes, so this class of failure cannot come back:\n\n* the portable `datetime.timezone.utc` spelling is used again, which runs on\n  both versions and makes the runtime bump safe to land in either order;\n* the tests run on the deployed runtime as well as the target one, and UP017 is\n  disabled until the App Service has been bumped;\n* the README documents that the App Service runtime, the CI matrix and the\n  linter target have to be kept in step, with the command to raise the runtime.\n\nVerified on a real 3.10 interpreter: the reported URL and every other commit\nview answer 200, the suite passes on 3.10 and 3.13, and reintroducing the alias\nfails 17 tests on 3.10.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"7d42b7111301aefda42ca2df1c18e4d7f295d00d","url":"https://github.com/lrivallain/azure_docs_watcher/commit/7d42b7111301aefda42ca2df1c18e4d7f295d00d"},{"author":"lrivallain","date":"2026-08-17T15:06:14+00:00","message":"Reuse the table rows for the section index\n\nThe section index was a Bootstrap table while the two other lists had become\ncard rows, so the three lists of the application no longer looked related. It\nnow uses the same rows, frame, density and hover halo.\n\nA grid of sections would carry no information, so that page forces the table\nlayout instead of offering the switch. Forcing happens in the same pre-paint\nscript that applies the colour theme, and deliberately does not write to local\nstorage: the layout chosen on the other pages is left untouched.\n\nMeasured on the three pages with the same stored preference: identical row\nheight, hover shadow, border and background.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"eb0ea751168a61c2d8b29e8698c309e08d60b9d8","url":"https://github.com/lrivallain/azure_docs_watcher/commit/eb0ea751168a61c2d8b29e8698c309e08d60b9d8"},{"author":"lrivallain","date":"2026-08-17T14:45:33+00:00","message":"Add tooltips on every button and underline the hovered table row\n\nTooltips are initialised once for every link and button carrying a title,\nrather than by tagging each element, so new markup gets one for free. Elements\nalready driving another behaviour through data-bs-toggle, the navbar collapse,\nare skipped.\n\nAuditing the rendered pages showed two buttons had no title at all and would\ntherefore have stayed silent: \"Browse sections\" on the home page and \"View\" on\nthe commit list. Both now describe their target.\n\nIn the table view the row under the pointer gets the accent colour as an inset\nunderline and a background tint, which replaces the card ring that did not suit\na table. The underline is drawn as an inset shadow so the row does not shift.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"6c06660b64ae15f79cbcbc720d0d0479430bc3d3","url":"https://github.com/lrivallain/azure_docs_watcher/commit/6c06660b64ae15f79cbcbc720d0d0479430bc3d3"},{"author":"lrivallain","date":"2026-08-17T14:41:03+00:00","message":"Offer a grid or a dense table layout, remembered across visits\n\nBoth the repository list and the commit list can now be shown as a grid of\ncards or as a table. The preference is stored in local storage, shared by the\ntwo pages, and applied before the first paint like the colour theme, so the\nlayout does not flicker on load.\n\nThe table view is a real table rather than spaced out cards: the collection\nbecomes the frame, the cards become flush rows separated by a single divider,\ncard caps lose their background, padding is tightened and the sha and date are\nkept on one line. Rows are 38px instead of 60px, which shows 17 repositories on\na first screen where the grid showed 7.\n\nTwo layout bugs surfaced while measuring this:\n\n* A single 78 line merge message stretched its whole row to 2883px, because the\n  cards use h-100. Commit messages are now clamped, to eight lines in the grid\n  and one in the table, with the full text kept in a title attribute.\n* The repository icon padding came from Bootstrap's p-3 utility, which is\n  !important and silently won over the table rules. It now lives in the\n  stylesheet so the table view can tighten it.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"a300d1740fc82d495608341375d3218d2249a347","url":"https://github.com/lrivallain/azure_docs_watcher/commit/a300d1740fc82d495608341375d3218d2249a347"},{"author":"lrivallain","date":"2026-08-17T14:22:02+00:00","message":"Pre-configure the repositories azure-docs was split into\n\nMicrosoft has been carving MicrosoftDocs/azure-docs into per-domain\nrepositories. Virtual machines, AKS, Cosmos DB, Monitor, AI services, machine\nlearning and Defender for Cloud are no longer in it, so the curated list had\nquietly lost most of the services it advertises. This follows that content to\nits new homes and adds the guidance repositories alongside it.\n\nTheir default branches are not uniform, which the branch autodiscovery already\nhandles: defender-docs publishes from `public`, sql-docs from `live`.\n\nRepositories with no product icon now render a Bootstrap glyph through a shared\nmacro, which also fixes an unguarded <img> on the home page that would have\nrendered a broken image for any entry without one. Section listings drop the dot\nand underscore prefixed tooling folders, which are not documentation.\n\nEvery configured repository was verified end to end: index page, first section\nand its RSS feed.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"f2c087c938251eb7d8c2a7ce6d6eb231209d29da","url":"https://github.com/lrivallain/azure_docs_watcher/commit/f2c087c938251eb7d8c2a7ce6d6eb231209d29da"},{"author":"lrivallain","date":"2026-08-17T14:10:18+00:00","message":"Simplify the configuration and polish the commit list\n\nAZDOCSWATCH_MAX_COMMITS could only lower a count that GitHub already fixes at\nthe feed size, so it was a knob that could never help. The remaining constant is\nno longer configurable and only tells visitors when a listing is capped, hence\nits rename to ATOM_FEED_SIZE.\n\nAlso renames the header \"About\" entry to \"GitHub\", which is what it links to,\nand highlights a commit card with a coloured border when it is pointed at or\nkeyboard focused. The rule lives in a static stylesheet rather than inline, and\nis disabled under prefers-reduced-motion.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"254dccc51830cdec05107371f997e7ff25bf1bf0","url":"https://github.com/lrivallain/azure_docs_watcher/commit/254dccc51830cdec05107371f997e7ff25bf1bf0"},{"author":"lrivallain","date":"2026-08-17T14:06:19+00:00","message":"Always show the 20 most recent commits instead of a look-back window\n\nGitHub caps commit feeds at 20 non paginated entries with no date filter, so a\nlook-back window could only ever hide results that had already been fetched.\n\nIt also made quiet sections useless: a section whose last change is older than\nthe window reported no activity at all, when what a reader wants to know is\nprecisely when it last changed. `articles/aks` for instance now shows its real\nhistory from 2024 rather than \"No commit in the last 5 days\".\n\nRemoves the \"Look back over\" control, the `since` parameter and the\n`AZDOCSWATCH_SINCE` and `AZDOCSWATCH_MAX_SINCE` settings. Existing links and\nfeed subscriptions carrying `?since=` keep working, the parameter is ignored.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"02a7cdcc8e1b9c94b9996cb85e6f5ae19bbf0d5d","url":"https://github.com/lrivallain/azure_docs_watcher/commit/02a7cdcc8e1b9c94b9996cb85e6f5ae19bbf0d5d"},{"author":"lrivallain","date":"2026-08-17T14:02:49+00:00","message":"Do not let low level I/O failures escape as unhandled errors\n\nrequests.exceptions.RequestException derives from OSError, so catching OSError\ncovers both the request level failures and the lower level ones that were\nescaping, such as an unusable TLS CA bundle. Those surfaced as a bare 500\ninstead of the error page, with no indication of the cause.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"1a515a917a72c1a3293b05117484807cbf88ebe7","url":"https://github.com/lrivallain/azure_docs_watcher/commit/1a515a917a72c1a3293b05117484807cbf88ebe7"},{"author":"lrivallain","date":"2026-08-17T14:00:01+00:00","message":"Drop the GitHub credential requirement and modernize the app\n\nThe shared GITHUB_ACCESS_TOKEN had become a recurring chore: organizations can\ncap personal access token lifetimes to a few days, so the deployment depended on\na manual renewal.\n\nCommits are now read from the public Atom feeds published by the GitHub web\nfront-end, which need no credential and consume no REST API rate limit. The\ndefault branch is discovered from the branch-less feed title, which is required\nbecause repositories disagree on it (sql-docs uses `live`). The only remaining\nREST call is the directory listing, performed anonymously and cached.\n\nThe oAuth login was removed with it: it only existed to raise limits that no\nlonger apply, and it was the sole source of the SAML enforcement problem (#10).\nThe `since` control is now available to everyone.\n\nKnown limitation: GitHub serves commit feeds as a single, non paginated page of\n20 entries, so a section can never show more than 20 commits. The previous\nimplementation was capped at 20 too, so this is not a regression.\n\nAlso fixed along the way:\n* RSS entries were published oldest first, and the channel link pointed at the\n  feed instead of the HTML page.\n* The RSS author was an email field holding a display name; it is now dc:creator.\n* Commit messages were HTML escaped before being XML escaped, producing double\n  escaped entities in the feeds.\n* A NameError was raised instead of the intended error page on GitHub failures.\n* The Flask secret key was regenerated on every start, breaking sessions across\n  restarts and workers.\n* The page language was declared as French while the interface is English.\n\nModernization:\n* Bootstrap 5.3 native colour modes replace the abandoned bootstrap-dark-5 fork;\n  jQuery and js-cookie are gone and CDN assets are pinned with SRI.\n* Pages advertise their RSS feed through autodiscovery links.\n* PyGithub, flask_dance, authlib and Flask-Login dropped; dependencies pinned.\n* Added an offline test suite, ruff linting and formatting, and a CI workflow\n  that lints and tests before deploying. The previous workflow relied on the\n  retired v2 artifact actions and could no longer run.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>\nCopilot-Session: 372234e2-8676-4a29-8c30-4e689a0a406a","sha":"e8828a047fd3c55321aad56b6afff1e5ab2734a7","url":"https://github.com/lrivallain/azure_docs_watcher/commit/e8828a047fd3c55321aad56b6afff1e5ab2734a7"}]