Next steps on layering?

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