I guess the main problem with the two wikis was that they more or less
look identically, so it was hard to find out in which wiki-space I am.
So I am +1 for moving the release docs to drupal to make clear that they
are different from the wiki that reflects work in progress.
What the current proposal misses is taht we discussed to enable a
comment feature on the release (and maybe even on the trunk docs) to
allow users to give feedback to the docs or share their workarounds etc.
Here's an example from the jquery docs [1].
Rüdiger
[1] http://api.jquery.com/hide/
Am 14.02.2012 00:56, schrieb Greg Logan:
Yes, along with (hopefully) the accidental links which send users from the
stable release docs into the trunk docs. In effect the release docs are a
snapshot of the trunk docs just before the release, with a layer of QA applied
to ensure that they are accurate and up to date.
G
Michelle Ziegmann<[email protected]> wrote:
I think Chris was asking if we are getting ridding of the Documentation
space within our wiki
(http://opencast.jira.com/wiki/display/MHDOC/Matterhorn+Documentation).
This would go away, yes?
Michelle
On 2/13/12 3:23 PM, Jaime Gago wrote:
Chris,
My understanding during the Unconference session was *not* to get rid of the
wiki.
What I understood about the proposal is to have a static official version of
the documentation that matches the actual Matterhorn release that would be
approved similar to the way the release is (i.e. QA).
The wiki wouldn't be gone as it would be the needed canvas where to update the
docs for the upcoming releases and also a space to add new page for say dev
recipes.
One way to look at technical documentation writing is to compare it to code
writing, with branches, release candidates and official releases, basically
versioning, the official release doc being that static document that is pushed
to the official channels (i.e. outside of the wiki) at the same time as the
official released code.
J.
On Feb 13, 2012, at 2:40 PM, Michelle Ziegmann wrote:
Are we talking about abandoning the wiki completely for docs? (I don't
particularly like this idea)
I think that's the idea, yes. I'd love to hear your thoughts about this, Chris.
It's an idea that came up during the Opencast conference.
_______________________________________________
Matterhorn mailing list
[email protected]
http://lists.opencastproject.org/mailman/listinfo/matterhorn
To unsubscribe please email
[email protected]
_______________________________________________
--
Michelle Ziegmann
Electronic Communications Specialist
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]
_______________________________________________
_______________________________________________
Matterhorn mailing list
[email protected]
http://lists.opencastproject.org/mailman/listinfo/matterhorn
To unsubscribe please email
[email protected]
_______________________________________________
--
________________________________________________
Rüdiger Rolf, M.A.
Universität Osnabrück - Zentrum virtUOS
Heger-Tor-Wall 12, 49069 Osnabrück
Telefon: (0541) 969-6511 - Fax: (0541) 969-16511
E-Mail: [email protected]
Internet: www.virtuos.uni-osnabrueck.de
_______________________________________________
Matterhorn mailing list
[email protected]
http://lists.opencastproject.org/mailman/listinfo/matterhorn
To unsubscribe please email
[email protected]
_______________________________________________
