ubuntu-manual team mailing list archive

[Patrick Dickey <pdickeybeta@xxxxxxxxx>]

Sorry for the second email, but I just read through the minutes.

1. I didn't join the docs team because I didn't realize that I could
contribute there. When I joined the Manual, it was more a "oh, I can
help out? OK" type of thing.

2. The benefit of the manual is that it's written in plain-English
without the technical jargon that you find in the official
documentation. Like you said in the chat, it goes into the why a little
more than just saying "Here's how to do it". I think more people
(especially those who are just starting out) would appreciate that. Plus
we include pictures and examples, where the documentation just says
"Here's what you do".

3.  As I mentioned in my other email, I think that we should combine
forces and work on both. If they have active members and we have active
members, we could cover both pretty easily. We're not really duplicating
them, as much as we're going more in depth on the basics. Plus we don't
really cover a lot of the technical or advanced stuff like they do.

4. I'm not as active as I'd like to be, but I'll consider joining the
docs team if we do disband.

5. Exactly what IS the desktop documentation? Pretty much everything
that I search for on ubuntu gives me just web pages with no real
structure. The only structured thing I see is the Server Guide. Are they
considering making an actual Desktop Guide? If so, then we could jump
right in on that (as that's essentially what the manual is).

That's my .02 worth. If they want to make some form of structure for
their documentation, I think we could definitely do that. But if it's
just going to be a search and pray like now, then we still need the
manual.

Have a great day.:)
Patrick.

(I think the Ubuntu Docs is the only thing I've ran into where there's
no attempt at a table of contents (or it's hidden pretty well). Even
Fedoras documentation is laid out as a wiki with a TOC.)


On Sun, 2014-07-13 at 01:57 -0500, Kevin Godby wrote:
> Hello, everyone.
> 
> At the last Ubuntu Docs meeting, it was proposed that the Ubuntu
> Manual project be shut down and the Ubuntu Manual team members join
> the Ubuntu Docs team and work on the desktop documentation instead.
> 
> You can read the logs of our discussion at
> <http://ubottu.com/meetingology/logs/ubuntu-meeting-2/2014/ubuntu-meeting-2.2014-07-02-17.00.log.html#l-179>.
> 
> The docs team asked that I email the Ubuntu manual team members to
> gauge your interest and collect your thoughts on the idea.
> 
> So I'll turn the floor over to you. Here are a few questions we should consider:
> 
> What do you think of this proposal?
> 
> Do you think the Ubuntu Manual project should be disbanded?
> 
> If the Ubuntu Manual project were to disband, would you be interested
> in joining the Ubuntu Docs team to work on the documentation there?
> 
> Why did you choose to join the manual team instead of the docs team?
> 
> Do you have any other thoughts on this proposal?
> 
> Thanks for your input!
> 
> —Kevin Godby
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~ubuntu-manual
> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual
> More help   : https://help.launchpad.net/ListHelp