{"html_url": "https://github.com/simonw/datasette/issues/1608#issuecomment-1017969452", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/1608", "id": 1017969452, "node_id": "IC_kwDOBm6k_c48rPss", "user": {"value": 9599, "label": "simonw"}, "created_at": "2022-01-20T22:07:55Z", "updated_at": "2022-01-20T22:07:55Z", "author_association": "OWNER", "body": "I think I want a banner at the top of the page making it obvious which version the documentation is talking about. This can be pretty low key for the current stable release, but should be visually more prominent for the `/latest/` branch and for older releases.", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 1109808154, "label": "Documentation should clarify /stable/ vs /latest/"}, "performed_via_github_app": null} {"html_url": "https://github.com/simonw/datasette/issues/1608#issuecomment-1017970132", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/1608", "id": 1017970132, "node_id": "IC_kwDOBm6k_c48rP3U", "user": {"value": 9599, "label": "simonw"}, "created_at": "2022-01-20T22:08:55Z", "updated_at": "2022-01-20T22:08:55Z", "author_association": "OWNER", "body": "Might want to consider SEO here too - I want people from search engines to land on `/stable/`, I wonder if I should noindex or `rel=canonical` the other documentation versions? Not sure what best practices for that is.", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 1109808154, "label": "Documentation should clarify /stable/ vs /latest/"}, "performed_via_github_app": null} {"html_url": "https://github.com/simonw/datasette/issues/1608#issuecomment-1017971905", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/1608", "id": 1017971905, "node_id": "IC_kwDOBm6k_c48rQTB", "user": {"value": 9599, "label": "simonw"}, "created_at": "2022-01-20T22:11:40Z", "updated_at": "2022-01-20T22:11:40Z", "author_association": "OWNER", "body": "Huh, I had forgotten I already have a banner on older versions:\r\n\r\n![D1A65C68-9A37-4FA2-80C4-534739A9D292](https://user-images.githubusercontent.com/9599/150430410-1e22e23f-ed27-4271-89ff-63467eb5f466.jpeg)\r\n", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 1109808154, "label": "Documentation should clarify /stable/ vs /latest/"}, "performed_via_github_app": null} {"html_url": "https://github.com/simonw/datasette/issues/1608#issuecomment-1017975322", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/1608", "id": 1017975322, "node_id": "IC_kwDOBm6k_c48rRIa", "user": {"value": 9599, "label": "simonw"}, "created_at": "2022-01-20T22:17:01Z", "updated_at": "2022-01-20T22:27:07Z", "author_association": "OWNER", "body": "Turns out that banner is something that ReadTheDocs implemented - I found it using GitHub code search, it's produced by this piece of JavaScript: https://github.com/readthedocs/readthedocs.org/blob/0852d7c10d725d954d3e9a93513171baa1116d9f/readthedocs/core/static-src/core/js/doc-embed/version-compare.js#L13-L21\r\n\r\n```javascript\r\nfunction init(data) {\r\n var rtd = rtddata.get();\r\n\r\n /// Out of date message\r\n\r\n if (data.is_highest) {\r\n return;\r\n }\r\n\r\n var currentURL = window.location.pathname.replace(rtd['version'], data.slug);\r\n var warning = $(\r\n '
Note
' +\r\n '' +\r\n 'You are not reading the most recent version of this documentation. ' +\r\n ' is the latest version available.' +\r\n '
' +\r\n 'Note
\r\n\r\n This documentation covers the development version of Datasette.
\r\nSee this page for the current stable release.\r\n
\r\nNote
\r\n>\r\n> This documentation covers the development version of Datasette.
\r\n>See this page for the current stable release.\r\n>
\r\n>Note
\r\n\r\n This documentation covers the development version of Datasette.\r\n
\r\n\r\n See this page for the current stable release.\r\n
\r\n `;\r\n var mainArticle = document.querySelector(\"article[role=main]\");\r\n mainArticle.insertBefore(warning, mainArticle.firstChild);\r\n }\r\n });\r\n});\r\n```", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 1109808154, "label": "Documentation should clarify /stable/ vs /latest/"}, "performed_via_github_app": null} {"html_url": "https://github.com/simonw/datasette/issues/1608#issuecomment-1484276946", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/1608", "id": 1484276946, "node_id": "IC_kwDOBm6k_c5YeETS", "user": {"value": 9599, "label": "simonw"}, "created_at": "2023-03-26T23:41:11Z", "updated_at": "2023-03-26T23:41:11Z", "author_association": "OWNER", "body": "It's working again now: https://docs.datasette.io/en/latest/sql_queries.html", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 1109808154, "label": "Documentation should clarify /stable/ vs /latest/"}, "performed_via_github_app": null}