home / github / issue_comments

Menu
  • Search all tables
  • GraphQL API

issue_comments: 691566247

This data as json

html_url issue_url id node_id user created_at updated_at author_association body reactions issue performed_via_github_app
https://github.com/simonw/datasette/issues/519#issuecomment-691566247 https://api.github.com/repos/simonw/datasette/issues/519 691566247 MDEyOklzc3VlQ29tbWVudDY5MTU2NjI0Nw== 9599 2020-09-12T22:48:53Z 2020-09-12T22:48:53Z OWNER

I think I've figured out what to do about stability of the HTML and the default templates with respect to semantic versioning.

I'm going to announce that the JSON API - including the variables made available to templates - should be considered stable according to semver. I will only break backwards compatibility at that level in a major version release.

The template HTML (and default CSS) will not be considered a stable interface. They won't change on bug fix releases but they may change (albeit described in the release notes) on minor version bumps.

Since the template inputs are stable, you can run your own copy of the previous version's templates if something breaks.

This means users (and plugin authors) who make changes to the default Datasette UI will have to test their changes against every minor release. I think that's OK.

If you write plugins that don't affect the Datasette HTML UI you will be able to expect stability across minor version releases.

{
    "total_count": 0,
    "+1": 0,
    "-1": 0,
    "laugh": 0,
    "hooray": 0,
    "confused": 0,
    "heart": 0,
    "rocket": 0,
    "eyes": 0
}
459590021  
Powered by Datasette · Queries took 1.473ms · About: github-to-sqlite