OSGi.org Wiki Proposal
Alex Blewitt sees a lack of how can I use / why should I use…? documentation.
Do you struggle to find answers to “how can I use…” and “why should I use…” amongst all the vendor-specific documentation out there? Alex Blewitt has proposed a new OSGi.org hosted wiki, to answer these very questions.
In his opinion, such a wiki is needed, due to the limitations of existing documentation. Documentation such as Request for Comments describe the contract of the service provider, not the end user; and specifications tend to focus on behaviour and ignore how end users might tailor it to fit their partiular needs. Other information readily available on the web, tends to be restricted to runtime-specific examples, and wikis that currently exist in the community are mostly vendor-specific. Therefore, Blewitt argues that current documentation fails to address the big questions of “How can I use…” and “Why should I use…” He envisons a single place where users can go to gain this information, regardless of technology and vendor.