Please refer to the first Michelle's email in this thread. I think she addressed that question (and also made some interesting proposals) On 15 Feb, 2012 21:22, "Christopher Brooks" <[email protected]> wrote:
> I'm still unclear who is the one who has to move the docs out of the > wiki and into drupal. My concern is that this is just another task for > the already overburdened release manager to take on. Right now the > docs can just be copied between spaces, and quickly updated. No need > to learn new tools, setup new infrastructure (accounts/etc.) or go > through a tedious process (copying content). > > Can a proponent of this proposal please put me at ease? > > Where do docs for previous releases lie in this proposal? > > Chris > > On Tue, 14 Feb 2012 11:28:31 +0100 > Ruediger Rolf <[email protected]> wrote: > > > 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] > > > _______________________________________________ > > > > > > > > -- > Christopher Brooks, BSc, MSc > ARIES Laboratory, University of Saskatchewan > > Web: http://www.cs.usask.ca/~cab938 > Phone: 1.306.966.1442 > Mail: Advanced Research in Intelligent Educational Systems Laboratory > Department of Computer Science > University of Saskatchewan > 176 Thorvaldson Building > 110 Science Place > Saskatoon, SK > S7N 5C9 > _______________________________________________ > 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] _______________________________________________
