I would like to discuss Commons 3.x documentation - where, how, when, who...
At the moment there are two places where Commons users can find documentation:
- Commons community documentation group - login not required to view, mostly unstructured docs
- Acquia Drupal Commons documentation - login required to view, structured docs
Where, how and when?
I would like to suggest that at this point we start to gather documentation about Commons 3.x and that drupal.org distribution documentation page become official Commons community documentation home.
- We would have structured documentation that you can browse without requirement to sing up.
- It is consistent with Commons philosophy about having official development and support at drupal.org in transparent and collaborative way.
- Collaborative editing of Commons documentation on drupal.org can bring only good to Drupal/Commons community.
- Groups.drupal.org will run on Commons 3.x, so it would be nice to have all under the same *.drupal.org roof.
- Greater visibility of Drupal Commons distribution and documentation (because of drupal.org SEO karma)
- I believe there can be found more pro arguments that I can't think of at the moment. :)
Some reasons why to start making documentation right now:
- We could easily make use of structured (architecture and design) documentation for e.g. writing article about GDO for Drupal Case Studies.
- Generally, in software development documentation is as important as the software itself, and IMO it would be really nice to have good documentation as soon as Commons 3.0 is released. :)
I understand that from the business logic point of view this idea maybe doesn't sound good, but, I'm strongly convinced that this approach can only bring benefit to all involved parties.
After all, it's only logical step - why stop at providing only open source software when you can also provide open source documentation? ;)