{"action":"opened","issue":{"url":"https://api.github.com/repos/web-platform-tests/wpt/issues/12484","repository_url":"https://api.github.com/repos/web-platform-tests/wpt","labels_url":"https://api.github.com/repos/web-platform-tests/wpt/issues/12484/labels{/name}","comments_url":"https://api.github.com/repos/web-platform-tests/wpt/issues/12484/comments","events_url":"https://api.github.com/repos/web-platform-tests/wpt/issues/12484/events","html_url":"https://github.com/web-platform-tests/wpt/issues/12484","id":350600086,"node_id":"MDU6SXNzdWUzNTA2MDAwODY=","number":12484,"title":"How to name reference files","user":{"login":"frivoal","id":113268,"node_id":"MDQ6VXNlcjExMzI2OA==","avatar_url":"https://avatars0.githubusercontent.com/u/113268?v=4","gravatar_id":"","url":"https://api.github.com/users/frivoal","html_url":"https://github.com/frivoal","followers_url":"https://api.github.com/users/frivoal/followers","following_url":"https://api.github.com/users/frivoal/following{/other_user}","gists_url":"https://api.github.com/users/frivoal/gists{/gist_id}","starred_url":"https://api.github.com/users/frivoal/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/frivoal/subscriptions","organizations_url":"https://api.github.com/users/frivoal/orgs","repos_url":"https://api.github.com/users/frivoal/repos","events_url":"https://api.github.com/users/frivoal/events{/privacy}","received_events_url":"https://api.github.com/users/frivoal/received_events","type":"User","site_admin":false},"labels":[{"id":125445429,"node_id":"MDU6TGFiZWwxMjU0NDU0Mjk=","url":"https://api.github.com/repos/web-platform-tests/wpt/labels/docs","name":"docs","color":"fbca04","default":false},{"id":528868416,"node_id":"MDU6TGFiZWw1Mjg4Njg0MTY=","url":"https://api.github.com/repos/web-platform-tests/wpt/labels/policy","name":"policy","color":"fbca04","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-08-14T21:13:32Z","updated_at":"2018-08-14T21:13:32Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"There is existing documentation that says that refs files should be named after the first test that they match. That documentation is old, and in the csswg wiki. It's unclear if it is supposed to apply to wpt, but at the same time, wpt does not document any other practice, so presumably it still applies, at least for css. But in some PRs (see #11323 for instance), there are proposals to give descriptive names to the ref files, especially when they are shared, instead of naming them after the tests they are a ref for.\r\n\r\nI'd like to see either:\r\n*    agreement that the rules haven't changed from the old csswg practices, and document that in wpt\r\n*    agreement that using descriptive names for reused refs is better, document that in wpt, and delete the contradicting information from the csswg wiki\r\n\r\nI don't care which one we do, as long as we keep documentation and practice in sync.\r\n\r\nSeveral people in #11323 have argued in favor of using descriptive names for shared refs is better, so I guess we should go with that.\r\n\r\nI would still like to hear from someone who was involved in setting the previous policy before overturning it though. @plinss @fantasai @svgeesus @TalbotG "}}
{"actor":{"display_login":"frivoal"}}