Hi guys
Whilst working on getting to know OODT better I walked through the CAS
Curation tutorial on the website and found it both hard to read and
buggy in places. I also (as a newbie) found getting started and tutorial
stuff tricky to locate with bits being on the main website and some on
the wiki. I guess this is left over from the Apache ingestion.
I took the liberty of migrating the original Curation tutorial over to
the wiki and made a few tweaks although I would like to improve this
further over the next week or so:
https://cwiki.apache.org/confluence/display/OODT/Deploying+and+using+CAS+Curator
My question is really this, is there a documentation policy with regards
to creating stuff and guiding new users. Personally I feel that as much
of the documentation as possible should be moved across to the wiki to
allow users to develop and maintain it as OODT grows and changes (and
allows people to fix errors). Also finding the wiki isn't very obvious
from the main OODT website, I would suggest that whoever maintains the
website puts the wiki link into the header or something allowing people
easy access to it, otherwise its buried in various page menus.
Having worked closely with a number of open source tools over the years,
especially as a newbie, I find the wiki documentation invaluable in
getting started and guiding new users, if no one has any objections I'd
like to put some time and effort into organising the wiki and landing
pages on their in a way that helps guide people in a more effective
manner. This will clearly be extended as I learn more myself :)
Cheers
Tom