[UCLP] "extra documentation library"

[Luke-Jennings]

On Mon, 2010-06-14 at 09:34 -0700, Elizabeth Krumbach wrote:
> On Sun, Jun 13, 2010 at 5:15 PM, Luke-Jennings
> <ubuntujenkins at googlemail.com> wrote:
> > Hello all,
> 
> Hi Luke!
> 
> > Along with the quickshot team I was asked to design/make a program for
> > the manual project that would go into mavrick so people could to sudo
> > apt-get install ubuntu-manual . Then fetch the latest version of the
> > manual in their language. In our latest meeting it was discussed that
> > quick start guides would be made along with the doc team.
> 
> Great to hear.
> 
> > Due to uni work I have not had proper time to look into the roll of the
> > learning team but my current understanding is that you produce
> > documentation for people to use in classrooms and learning events.
> > Please correct me if I am wrong.
> 
> That's correct, for an example of a class layout check out:
> 
> http://doctormo.org/2009/07/15/ubuntu-system-admin-class-command-line-basics/

Those documents would be great as a "comand line" subsection in the left
hand pane. 
> 
> We're still tied up with formatting issues (docbook (I spent some time
> with this last week, oh boy...)? mallard? latex? what did other teams
> end up going with?) so it's not in bzr (some classes are on the wiki,
> others are just open office to pdf), so apologies on the pdfs.

Yes would should sort that out, nice to make a start.
> 
> > I also thought about the roll of the learning team and thought this idea
> > [1] could be developed to work with learning team material as well. The
> > idea is very rough and is the very first draft, I will say I am not the
> > best as drawing.
> >
> > If you look at the picture you will see that down the left you have
> > section/topics in which you can use to filter the number of files that
> > you see. In the right you see a preview image of the cover a little
> > description and size and a choice of languages if available.
> >
> > The user selects the file and clicks download and the file is downloaded
> > on to the folder they have chosen. Once it is downloaded it can be
> > opened using their favourite/default viewer for that type of document.
> >
> > One particular use case that I see is on events people could refer to
> > particular "lessons" for all the documents they need for that session.
> > Also the option to search through the available documents could be a
> > possibility.
> >
> > Every time I think about it the more complex the program gets, I would
> > like to understand if the team sees there being a use for a program such
> > as this. I see this as an "extra documentation library" (I have no real
> > name yet), any thoughts or suggestions are welcome.
> 
> I can't speak for the whole learning team, but this sounds like a
> really great project. Presumably the documents included would come
> from the documentation pool that was discussed at UDS that we all
> intend to contribute to? As you know, our documentation is all
> cc-by-sa like -docs and -manual so even if this isn't the case you'll
> be welcome to pull our documents from bzr, once we get them there.

The plan would be to take documentation that is made by the teams would
be in it. I don't think the whole pool would go in but all the pdfs and
odts odps etc would go in. Thanks I look forward to adding your content.
I very much see this program as a place to find all the extra
documentation produced by the docs/learning/manual team.

Luke Jeninngs

(ubuntujenkins on #freenode)