Recommendation template (Was: Editing process for Recommendations)

Here's a stake in the ground for our recommendation proposal template.

--- Begin template ---

Title
    Each proposal must have a short name by which we can refer to it.

Goals
    Each proposal must reference the WG Goals
<http://www.w3.org/2006/WSC/drafts/note/Overview.html#goals> the
proposal helps achieve.

Overview
    Each proposal must provide a brief overview of the problem it
addresses and general approach being proposed to fix the problem. This
section should reference the usability principles
<http://www.w3.org/2006/WSC/drafts/note/Overview.html#usability-principl
es> violated by the current approach, as well as any usability
principles that will be upheld by the proposal.

Dependencies
    Each proposal must reference the Available security information
<http://www.w3.org/2006/WSC/drafts/note/Overview.html#available> it
relies upon. (I'll add anchors to the Note that can be the target of
hyperlinks).

Use-cases
    Each proposal must reference the use-cases
<http://www.w3.org/2006/WSC/drafts/note/Overview.html#scenarios> it
addresses. This section must provide more detailed description of
exactly how the user will interact with the proposed user interface. The
details provided in this section must be sufficient to enable
lo-fidelity testing of the proposal.

Expected user behavior
    Each proposal must discuss the user behavior it relies upon and that
therefore must be tested. Each item should refer back to a step in the
"Use-cases" section of the proposal. For example, a proposal might rely
on the user reacting in a given way to a specified indicator. The
proposal must call out what the needed user reaction is, as well as what
user reactions might be detrimental to the user's interests. For each
item, the proposal should list the motivations for the user to react in
the desired way as well as any factors that reduce the user's motivation
to react in this way.

Disruption
    Each proposal should list any significant disruptions it makes to
current user habits for web browsing. This section should help the
reader understand what issues might cause the proposal to not be
deployed, despite advantages it may have.

--- End template ---

I think the above template gives us the information we need to evaluate
a proposal and proceed with testing and implementation. I realize that
the template asks for a lot of content from the author and so we might
not get complete documents for many of the proposals by the F2F, but I
think that's OK. At least we'll know what we don't know.

This email addresses ACTION-212.

Tyler

Received on Wednesday, 2 May 2007 17:25:11 UTC