I'm quickly loosing confidence in being able to create websites in SS because of the poor documentation.
I can't seem to get modules such as Newsletter or Gallery working. I'm sure if there was bettwer documentation then I'd be able to get it all up and running.
Things that are missing as regards to documentation are:
Where exactly do you place the extraced folders and files
What do you need to rename (a lot of support docs say "oh - you need to rename the folder blah blah..)
Which file do you need to edit to include the updates (_config.php - but which one in which folder structure)
Which release of SS does a particular module support
What are the latest trunk releases and where do you extract the files to?
Screen dumps of the major steps would be very welcome.
I agree that it would be great to get these modules to a more polished state. However, the lack of documentation is one of the reasons why those modules are listed in the "unsupported modules" section.
Realistically, getting these modules more polished in the near future is probably only going to happen if someone puts up their hand and offers to do this work.
If anyone is interested, posting to http://groups.google.com/group/silverstripe-dev would be appropriate.
Where exactly do you place the extraced folders and files. What do you need to rename (a lot of support docs say "oh - you need to rename the folder blah blah..)
There is no general 'How to Install Modules' page with 'Just extract it to the root folder, heres a screenshot of what the folder structure should look like'. Its really straightforward but if you have never done it before you still have to find out somewhere. Each INSTALL file contains the instructions but it would be handy to just have a global install info page. I might knock one up tonight.
Thanks for the offer to help with docs, Gravitational FX.
The following wiki pages provide the documentation as it currently stands:
You can sign up for an account on the wiki to edit those pages.
As for whether that's all that stands in the way of them being supported modules, well, no, it isn't - you also need someone who is going to fix bugs, etc! However, we are trying to find a maintainer for the googleanalytics and newsletter modules right now.