- 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