search

w3c / web-performance

W3C Web Performance Working Group repo
https://www.w3.org/webperf/
Other
411 stars 69 forks source link

Review whether new specs should be in Respec or Bikeshed #25

Open toddreifsteck opened 6 years ago

toddreifsteck commented 6 years ago

Bikeshed has better link validation mechanics at built time. Respec is the tool the group has been using.

We should evaluate whether we should change spec tools and what our process is for creating a new spec.

Possible additional issue to cover:

tdresser commented 6 years ago

@domenic

annevk commented 4 years ago

Not sure if this is too late, but please use Bikeshed. It makes it easier to move things between WHATWG and Web Performance documents as well as deal with cross-spec cross-references, and in general has a slightly better end user experience.

marcoscaceres commented 3 years ago

as deal with cross-spec cross-references,

ReSpec and BikeShed use the same terms database. http://respec.org/xref/

and in general has a slightly better end user experience.

That's open to debate ;)

But in all seriousness, you can find badly written specs using either tool - it's really a matter of how well people know the tooling and we are working on hopefully making the situation better for both ReSpec and BikeShed.