{"html_url": "https://github.com/simonw/datasette/issues/336#issuecomment-407450815", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/336", "id": 407450815, "node_id": "MDEyOklzc3VlQ29tbWVudDQwNzQ1MDgxNQ==", "user": {"value": 9599, "label": "simonw"}, "created_at": "2018-07-24T15:35:03Z", "updated_at": "2018-07-24T15:35:03Z", "author_association": "OWNER", "body": "Actually I do like the idea of a unit test that reminds me if I've forgotten to update the included files.", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 340039409, "label": "Ensure --help examples in docs are always up to date"}, "performed_via_github_app": null} {"html_url": "https://github.com/simonw/datasette/issues/336#issuecomment-404021890", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/336", "id": 404021890, "node_id": "MDEyOklzc3VlQ29tbWVudDQwNDAyMTg5MA==", "user": {"value": 9599, "label": "simonw"}, "created_at": "2018-07-11T02:09:25Z", "updated_at": "2018-07-11T02:09:25Z", "author_association": "OWNER", "body": "I decided against the unit tests, instead I have a new script called `./update-docs-help.sh` which I can run any time I want to refresh the included documentation: https://github.com/simonw/datasette/commit/aec3ae53237e43b0c268dbf9b58fa265ef38cfe1#diff-cb15a1e5a244bb82ad4afce67f252543", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 340039409, "label": "Ensure --help examples in docs are always up to date"}, "performed_via_github_app": null} {"html_url": "https://github.com/simonw/datasette/issues/336#issuecomment-403996143", "issue_url": "https://api.github.com/repos/simonw/datasette/issues/336", "id": 403996143, "node_id": "MDEyOklzc3VlQ29tbWVudDQwMzk5NjE0Mw==", "user": {"value": 9599, "label": "simonw"}, "created_at": "2018-07-10T23:21:27Z", "updated_at": "2018-07-10T23:21:27Z", "author_association": "OWNER", "body": "Easiest way to do this I think would be to make those help blocks separate files in the docs/ directory (publish-help.txt perhaps) and then include them with a sphinx directive: https://reinout.vanrees.org/weblog/2010/12/08/include-external-in-sphinx.html", "reactions": "{\"total_count\": 0, \"+1\": 0, \"-1\": 0, \"laugh\": 0, \"hooray\": 0, \"confused\": 0, \"heart\": 0, \"rocket\": 0, \"eyes\": 0}", "issue": {"value": 340039409, "label": "Ensure --help examples in docs are always up to date"}, "performed_via_github_app": null}