[proposal] Template for communicating our issues

Hi everyone,

to avoid losing too much time in collecting use cases and to ground our discussions in pragmatic cases meant to solve current issues, I propose to write our issues according to:


# Summary 
  What is the issue?
  (1 simple short sentence)

# Issue 
  What problem are we trying to solve (one issue only)
  (1 or 2 paragraphs)

# Positive Effects
  Why should we care? What are we improving for people? implementers?
  (1 or 2 paragraphs)

# Risks
  Are there any risks associated with this feature, proposal?
  What might fail and why?

# Implementations
  Is it already implemented?
  Where? How? Who?

# Related
  List of references
  (specification, tutorial, articles, code)


ps: mostly stolen from the W3C HTML WG and the (now defunct) W3C QA WG

-- 
Karl Dubost - http://dev.opera.com/
Developer Relations & Tools, Opera Software

Received on Saturday, 17 September 2011 22:38:44 UTC