ubuntu-doc Digest, Vol 45, Issue 22

Fri Jun 13 18:03:17 UTC 2008

Connor,

How can I get a part in cleaning up the wiki?

-----Original Message-----
From: ubuntu-doc-bounces at lists.ubuntu.com
[mailto:ubuntu-doc-bounces at lists.ubuntu.com] On Behalf Of
ubuntu-doc-request at lists.ubuntu.com
Sent: Friday, June 13, 2008 1:58 PM
To: ubuntu-doc at lists.ubuntu.com
Subject: ubuntu-doc Digest, Vol 45, Issue 22

Send ubuntu-doc mailing list submissions to
	ubuntu-doc at lists.ubuntu.com

To subscribe or unsubscribe via the World Wide Web, visit
	https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
or, via email, send a message with subject or body 'help' to
	ubuntu-doc-request at lists.ubuntu.com

You can reach the person managing the list at
	ubuntu-doc-owner at lists.ubuntu.com

When replying, please edit your Subject line so it is more specific
than "Re: Contents of ubuntu-doc digest..."

Today's Topics:

   1. Ubuntu Documenter (Robert Bowman)
   2. RE: PDF Documentation Guide (Dougie Richardson)
   3. RE: Expanding the documentation (Dougie Richardson)
   4. Re: Expanding the documentation (Connor Imes)
   5. Re: Ubuntu Documenter (Charles Davis)
   6. Re: Expanding the documentation (Charles Davis)
   7. Re: Ubuntu Documenter (Connor Imes)

----------------------------------------------------------------------

Message: 1
Date: Fri, 13 Jun 2008 13:40:27 -0400
From: "Robert Bowman" <rhbowman at dellen.com>
Subject: Ubuntu Documenter
To: <ubuntu-doc at lists.ubuntu.com>
Message-ID: <002301c8cd7c$91684e30$b438ea90$@com>
Content-Type: text/plain; charset="us-ascii"

Long time reader, short time poster.

I would like two point out three things that make it hard for someone new to
contribute.

1.     There are no definable goals.

2.     There is no documentation on how to do the documentation.

3.     Short of the bug list, there are no goals that you can work towards.

THE INFORMATION CONTAINED IN THIS EMAIL MESSAGE IS PRIVILEGED OR
CONFIDENTIAL INFORMATION INTENDED ONLY FOR THE USE OF THE INDIVIDUAL OR
ENTITY NAMED. IF THE READER OF THIS MESSAGE IS NOT THE INTENDED RECIPIENT,
YOU ARE HEREBY NOTIFIED THAT ANY DISSEMINATION, DISTRIBUTION OR COPYING OF
THIS COMMUNICATION IS NEITHER ALLOWED NOR INTENDED. IF YOU HAVE RECEIVED
THIS COMMUNICATION IN ERROR, PLEASE IMMEDIATELY NOTIFY US BY EMAIL AT
SECURITY at DELLEN.COM AND RETURN THE ORIGINAL MESSAGE TO US. 

THANK YOU. 

security at dellen.com

-------------- next part --------------
An HTML attachment was scrubbed...
URL:
https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080613/94ecb111/a
ttachment-0001.htm 

------------------------------

Message: 2
Date: Fri, 13 Jun 2008 18:41:13 +0100
From: "Dougie Richardson" <ddrichardson at btinternet.com>
Subject: RE: PDF Documentation Guide
To: "'Jonathan Jesse'" <jjesse at gmail.com>,	"'daniel haynes'"
	<danielhaynes1979 at hotmail.com>
Cc: ubuntu-doc at lists.ubuntu.com
Message-ID: <003001c8cd7c$ace6e130$06b4a390$@com>
Content-Type: text/plain; charset="us-ascii"

Hi Jonathon,

I have to disagree, I did a quick one [1] for the Server guide a few weeks
ago because someone on IRC couldn't and I think it came out quite well.

Cheers,

Dougie

[1] http://blog.lynxworks.eu/?p=63

Daniel,

Due to the way documents are organzied in the help system based on topics
the help system doesn't produce a good pdf.  

Jonathan

-------------- next part --------------
An HTML attachment was scrubbed...
URL:
https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080613/f8d37cf5/a
ttachment-0001.htm 

------------------------------

Message: 3
Date: Fri, 13 Jun 2008 18:45:59 +0100
From: "Dougie Richardson" <ddrichardson at btinternet.com>
Subject: RE: Expanding the documentation
To: <philbull at gmail.com>,	"'Connor Imes'" <rocket2dmn at aol.com>
Cc: 'Ubuntu Doc' <ubuntu-doc at lists.ubuntu.com>
Message-ID: <003501c8cd7d$5b899b10$129cd130$@com>
Content-Type: text/plain;	charset="us-ascii"

> Nevertheless, I think there is a need to mark-up documentation which
> has
> been recognised as being of good quality. Maybe something a little less
> intrusive than a banner across the top of the page, like a star (as per
> Wikipedia's "featured articles")?

Feel free to shoot this down but could we implement some JavaScript to allow
people to rate pages if they were useful.

This would give us a way to quantify not only what is useful but what is
also no longer accessed (if no one is using it then no one is rating it).
Simple five star roll over or such like, you know like IMDB[1] has.

Plus it looks cool.

Cheers,

Dougie

[1] http://www.imdb.com/ (if you haven't heard of IMDB, then you may need to
look up 1995 and the advent of the Internet, lol)

------------------------------

Message: 4
Date: Fri, 13 Jun 2008 10:50:09 -0700
From: Connor Imes <rocket2dmn at aol.com>
Subject: Re: Expanding the documentation
Cc: "'Ubuntu Doc'" <ubuntu-doc at lists.ubuntu.com>
Message-ID: <4852B351.7030306 at aol.com>
Content-Type: text/plain; charset=ISO-8859-1

Dougie Richardson wrote:
>> Nevertheless, I think there is a need to mark-up documentation which
>> has
>> been recognised as being of good quality. Maybe something a little less
>> intrusive than a banner across the top of the page, like a star (as per
>> Wikipedia's "featured articles")?
> 
> Feel free to shoot this down but could we implement some JavaScript to
allow
> people to rate pages if they were useful.
> 
> This would give us a way to quantify not only what is useful but what is
> also no longer accessed (if no one is using it then no one is rating it).
> Simple five star roll over or such like, you know like IMDB[1] has.
> 
> Plus it looks cool.
> 
> Cheers,
> 
> Dougie
> 
> [1] http://www.imdb.com/ (if you haven't heard of IMDB, then you may need
to
> look up 1995 and the advent of the Internet, lol)
> 

Functionality like that sounds like it could be useful, not sure on the
logistics of implementing it anytime soon, though.  Thoughts?
-Connor

------------------------------

Message: 5
Date: Fri, 13 Jun 2008 11:53:01 -0600
From: Charles Davis <oldsoldier at gmail.com>
Subject: Re: Ubuntu Documenter
To: Robert Bowman <rhbowman at dellen.com>
Cc: ubuntu-doc at lists.ubuntu.com
Message-ID: <1213379581.21374.11.camel at chuck-desktop>
Content-Type: text/plain; charset="us-ascii"

On Fri, 2008-06-13 at 13:40 -0400, Robert Bowman wrote:
> Long time reader, short time poster.
> 
>  
> 
> I would like two point out three things that make it hard for someone
> new to contribute.
> 
>  
> 
> 1.    There are no definable goals.
> 
This is difficult since documentation is a moving target! Being new to
the list and team I have learned "the hard way" that because of this
there is a lot to learn. In my opinion, part of the apparent lack of
goals has to do with the fact that the development version is subject to
a lot of change up until string freeze, then there is a mad dash to get
caught up.
> 2.    There is no documentation on how to do the documentation.
There is a fair amount of documentation in the Wiki regarding the
standards of documentation.
> 
> 3.    Short of the bug list, there are no goals that you can work
> towards.

There has been a lot of effort devoted toward cleaning up the Wiki and
revising the community wiki. TBH that is a huge goal and the guys
working on it right now could use some major help
> 
> 
> 
> 
> 
> ______________________________________________________________________
> THE INFORMATION CONTAINED IN THIS EMAIL MESSAGE IS PRIVILEGED OR
CONFIDENTIAL INFORMATION INTENDED ONLY FOR THE USE OF THE INDIVIDUAL OR
ENTITY NAMED. IF THE READER OF THIS MESSAGE IS NOT THE INTENDED RECIPIENT,
YOU ARE HEREBY NOTIFIED THAT ANY DISSEMINATION, DISTRIBUTION OR COPYING OF
THIS COMMUNICATION IS NEITHER ALLOWED NOR INTENDED. IF YOU HAVE RECEIVED
THIS COMMUNICATION IN ERROR, PLEASE IMMEDIATELY NOTIFY US BY EMAIL AT
SECURITY at DELLEN.COM AND RETURN THE ORIGINAL MESSAGE TO US. 
> 
> THANK YOU. 
> 
> security at dellen.com
> 
-- 
Chuck
OpenPGP Key ID:1024D/19B4CF71
Fingerprint: 0D29 4D49 AE37 48A6 2EC8 0746 11DA EF8B 19B4 CF71
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url :
https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080613/619eb01a/a
ttachment-0001.pgp 

------------------------------

Message: 6
Date: Fri, 13 Jun 2008 11:56:53 -0600
From: Charles Davis <oldsoldier at gmail.com>
Subject: Re: Expanding the documentation
To: Connor Imes <rocket2dmn at aol.com>
Cc: 'Ubuntu Doc' <ubuntu-doc at lists.ubuntu.com>
Message-ID: <1213379813.21374.15.camel at chuck-desktop>
Content-Type: text/plain; charset="us-ascii"

On Fri, 2008-06-13 at 10:50 -0700, Connor Imes wrote:
> Dougie Richardson wrote:
> >> Nevertheless, I think there is a need to mark-up documentation which
> >> has
> >> been recognised as being of good quality. Maybe something a little less
> >> intrusive than a banner across the top of the page, like a star (as per
> >> Wikipedia's "featured articles")?
> > 
> > Feel free to shoot this down but could we implement some JavaScript to
allow
> > people to rate pages if they were useful.
> > 
> > This would give us a way to quantify not only what is useful but what is
> > also no longer accessed (if no one is using it then no one is rating
it).
> > Simple five star roll over or such like, you know like IMDB[1] has.
> > 
> > Plus it looks cool.
> > 
> > Cheers,
> > 
> > Dougie
> > 
> > [1] http://www.imdb.com/ (if you haven't heard of IMDB, then you may
need to
> > look up 1995 and the advent of the Internet, lol)
> > 
> 
> Functionality like that sounds like it could be useful, not sure on the
> logistics of implementing it anytime soon, though.  Thoughts?
> -Connor
> 
I tend to agree with Connor in that it could be useful in validating the
user friendliness and completeness / usefulness of an article. I seem to
remember something of this nature in the MSKB although it was more
directed toward internal use.
-- 
Chuck
OpenPGP Key ID:1024D/19B4CF71
Fingerprint: 0D29 4D49 AE37 48A6 2EC8 0746 11DA EF8B 19B4 CF71
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url :
https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080613/737a767c/a
ttachment-0001.pgp 

------------------------------

Message: 7
Date: Fri, 13 Jun 2008 10:57:50 -0700
From: Connor Imes <rocket2dmn at aol.com>
Subject: Re: Ubuntu Documenter
Cc: ubuntu-doc at lists.ubuntu.com
Message-ID: <4852B51E.5050400 at aol.com>
Content-Type: text/plain; charset=ISO-8859-1

Charles Davis wrote:

> There has been a lot of effort devoted toward cleaning up the Wiki and
> revising the community wiki. TBH that is a huge goal and the guys
> working on it right now could use some major help

That seems to be one of the primary goals of the summer.  The users
coming from UF Beginners Team will primarily be helping get the wiki up
to date by cleaning shop and rewriting older but necessary documentation.
-Connor

------------------------------

-- 
ubuntu-doc mailing list
ubuntu-doc at lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc

End of ubuntu-doc Digest, Vol 45, Issue 22
******************************************

THE INFORMATION CONTAINED IN THIS EMAIL MESSAGE IS PRIVILEGED OR CONFIDENTIAL INFORMATION INTENDED ONLY FOR THE USE OF THE INDIVIDUAL OR ENTITY NAMED. IF THE READER OF THIS MESSAGE IS NOT THE INTENDED RECIPIENT, YOU ARE HEREBY NOTIFIED THAT ANY DISSEMINATION, DISTRIBUTION OR COPYING OF THIS COMMUNICATION IS NEITHER ALLOWED NOR INTENDED. IF YOU HAVE RECEIVED THIS COMMUNICATION IN ERROR, PLEASE IMMEDIATELY NOTIFY US BY EMAIL AT SECURITY at DELLEN.COM AND RETURN THE ORIGINAL MESSAGE TO US. 

THANK YOU. 

security at dellen.com