- From: Alex Russell <slightlyoff@google.com>
- Date: Thu, 16 May 2013 19:11:47 +0100
- To: "www-tag@w3.org List" <www-tag@w3.org>
- Cc: Yehuda Katz <wycats@gmail.com>, Marcos Caceres <w3c@marcosc.com>, Anne van Kesteren <annevk@annevk.nl>
- Message-ID: <CANr5HFW+Qc_Ygga+R7BaJK+8hE0dSYCH2UR2wHm+jen05fqG0w@mail.gmail.com>
As per today's call, it seems time for us to consider next steps regarding what concrete things we should be doing related to layering. As I see it, there are some open questions about what the tag *can* do, as well as what it *should* do. Here's a (smallish) list of ideas, all or none of which we could pursue. Looking for your ideas too, as I'm sure this list is missing quite a lot: - Create a more formal review process for specs. The public-script-coord@threads are great, and it would be good if there were a way for us to track our progress in review and follow-up on specs that ask for it. A nag-file for follow-ups alone might be worth it's weight in gold. - A page that helps WG's that want to "do it right" learn a set of concrete steps for how to engage best with us in helping to review their APIs early and most constructively. - A page that lists the specific strengths of the TAG's membership so that the right people can be pinged independently about issues. This seems obvious to us, but the world is a big place. - A guide for how to design an idiomatic API in anger, including but not limited to: - A discussion of imperative and declarative layering - A library of common patterns to employ along with copy/paste-able IDL and JS examples to show how they can be used - A discussion on how and when to think about the JS library ecosystem. - Some common TAG-approved design principles to keep in mind when considering how to formulate a feature's API surface area - A concrete walkthrough of an API that starts declarative in v1 and grows good, layered API later - A walkthrough of an API that starts imperative and grows a declarative expression in v2 What else? Is this list pitched at the wrong level?
Received on Thursday, 16 May 2013 18:12:17 UTC