[UCLP] "extra documentation library"

[Elizabeth Krumbach]

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/

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.

> 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.

-- 
Elizabeth Krumbach // Lyz // pleia2
http://www.princessleia.com