Hi all,
As part of the adopter documentation improvement initiative, I've gone
ahead and experimented with the idea we discussed on list to create a
separate wiki space for each version of the release docs. I copied each
page of the trunk docs into a new space at
http://opencast.jira.com/wiki/display/MHTRUNK/Home.
After playing around some, I think this will work well for us. Greg will
find it to be a much easier task to create a new version of the docs
with each release. There is a new plugin now to "Copy Space", so when
releasing a new version, you copy the entire MHTRUNK space to something
like MH14 - all links intact. No need to add " (1.4)" to the end of
every page to get around the unique page title issue either.
Links to the release docs will be provided in
http://opencast.jira.com/wiki/display/MHDOC/Matterhorn+Documentation.
If there is agreement with this proposal, the next steps I will take are:
1. Delete all of these pages -
http://opencast.jira.com/wiki/display/MH/Trunk. Instead, confluence
users will have access to edit
http://opencast.jira.com/wiki/display/MHTRUNK/Home (I just made the copy
today, so everything is up to date as of earlier this afternoon).
2. Move each version of release docs from
http://opencast.jira.com/wiki/display/MHDOC/Matterhorn+Documentation to
individual spaces, then provide the links to those spaces. These spaces
will only be editable by the documentation maintainers.
3. Open up the permissions for MHDOC so that any current confluence
users can edit and contribute guides.
4. Continue restructuring
http://opencast.jira.com/wiki/display/MHDOC/Matterhorn+Documentation to
more of an "Adopter Guides" focus, with links to the release docs plus
other useful guides for adopters. Some documents from the developer's
wiki will be moved here that are relevant for adopters. The general
structure was proposed in an earlier thread http://goo.gl/1YJ8J.
Please let me know if you have any questions, suggestions or concerns
about this proposal. I'd like to make these moves as soon as possible,
to avoid any duplication of effort with ongoing changes between the
current and new TRUNK docs.
Thanks!
Michelle
--
=================
Michelle Ziegmann
Technical Project Manager
Educational Technology Services
University of California Berkeley
_______________________________________________
Matterhorn mailing list
[email protected]
http://lists.opencastproject.org/mailman/listinfo/matterhorn
To unsubscribe please email
[email protected]
_______________________________________________
