Following on from other discussions, I have made a start on something here https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=71013028
In the end this will only work if people want to do it. But I do believe that one way of getting everyone on the same page here (and we do have clear signs that not everyone is), is to, quite literally, get everyone on the same page :). It is currently half content, half notes. There is more to harvest from list discussions I think, some topics have progressed further than when I started trying to capture ideas, so please correct any mistakes in the definitions or add topics and questions that need 'resolution'/guidance. I personally would like to see some concrete guidance in the 'How does PAYG get implemented' section. There were definitely the beginnings of some healthy discussions around some of the options for beads for example. (DRY, inheritance, utility functions etc). The goal here is to turn any list discussions around uncertainties/misunderstandings into something that represents consensus. I think this should be do-able by simple discussions about specific topics, maybe with informal voting if necessary. If there is no consensus then I guess PMC could do a formal vote? (I don't know what makes sense here) Beyond work on the SDK, this type of information (in some form) might also be helpful as part of the documentation for 1.0 when we get there, so it could save someone time later on as well as being useful in the near term (I hope).
