search

bocoup / web-platform-contribution-guide

Source code for the Web Platform Contribution Guide, a guidebook to becoming a web platform contributor.
https://wpc.guide
13 stars 1 forks source link

Add section on spec archaeology #141

Open boazsender opened 3 years ago

boazsender commented 3 years ago

Describe why we do this (to show where a bug was introduced, and explain the context around why it is okay to fix it), and how to do it (git log --grep...).

zcorpan commented 1 year ago

For HTML:

Clone the whatwg/html repo.

git log –grep "something"

Search the spec’s git commit log for “something” with the command above.

If you find a relevant commit, the commit message might link to an issue in GitHub, or a bug in W3C Bugzilla, or an email in the public-html@w3.org or whatwg@whatwg.org mailing lists.

If not, those all have public archives that are searchable. The commit has a date, there was probably some discussion leading to the change around the same time.

Further, archived discussion exists from IRC (see logs from 2006 to 2016, logs until June 2021). Now chat is active in Matrix (logs).