ubuntu-doc Digest, Vol 44, Issue 7
Vincent Rappa
hawkskater0 at gmail.com
Tue May 6 12:43:50 UTC 2008
I disagree with message two. I feel that the name should remain the same as
to not cause any confusion. I think that the purposed name does not sound as
good either.
On Tue, May 6, 2008 at 4:00 AM, <ubuntu-doc-request at lists.ubuntu.com> wrote:
> 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. [RFC] Ubuntu Manpages Website (Dustin Kirkland)
> 2. SpecSpec => SpecTemplate? (Neal McBurnett)
> 3. Re: [RFC] Ubuntu Manpages Website (Adam Sommer)
> 4. Re: SpecSpec => SpecTemplate? (Matthew East)
> 5. Re: Tech-review report of web-apps.xml ... (Phil Bull)
> 6. Re: Contributers (Phil Bull)
> 7. Re: I'd like to get involved. (Phil Bull)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Mon, 5 May 2008 16:13:45 -0500
> From: "Dustin Kirkland" <kirkland at canonical.com>
> Subject: [RFC] Ubuntu Manpages Website
> To: ubuntu-doc at lists.ubuntu.com
> Message-ID:
> <d9c105ea0805051413u6986ddb5j6a8af31c20c3aa2d at mail.gmail.com>
> Content-Type: text/plain; charset=ISO-8859-1
>
> Hi-
>
> I just registered a new blueprint, for a website dedicated to a
> comprehensive set of dynamically generated/updated HTML markup of all
> Ubuntu manpages.
>
> https://blueprints.launchpad.net/ubuntu-doc/+spec/ubuntu-manpage-website/
>
> I'm aware of http://manpages.debian.net and
> http://www.linuxmanpages.com, however neither of these are dedicated
> to the particular packages nor versions included in Ubuntu. I feel
> that this is an important piece of documentation missing from the
> publications on http://help.ubuntu.com. Please let me know if this
> information currently exists.
>
> I'm proposing a section of the Ubuntu documentation, perhaps
> http://help.ubuntu.com/manpages dedicated to this purpose.
>
> I have a working prototype temporarily at
> http://ubuntu.dustinkirkland.com/manpages with manpages from (dapper,
> edgy, feisty, gutsy, hardy) x (main, restricted, universe,
> multiverse). This constitutes approximately 2.1GB of data, and 250K
> HTML pages.
>
> Currently, there are 2 small shell scripts which are able to generate
> this data, and use man2html to render the HTML. While there is
> considerable room for improvement, the foundation is at least there.
> Also, it will be essential to have Google index the entire data set,
> for which we'd need accurate sitemaps, etc. such that the
> documentation search engines could use this data as well.
>
> I plan to spend some time (planned or ad hoc) at UDS Prague discussing
> this with a few key individuals.
>
> --
> :-Dustin
>
>
>
> ------------------------------
>
> Message: 2
> Date: Mon, 5 May 2008 17:11:35 -0600 (MDT)
> From: Neal McBurnett <neal at bcn.boulder.co.us>
> Subject: SpecSpec => SpecTemplate?
> To: ubuntu-doc <ubuntu-doc at lists.ubuntu.com>
> Message-ID: <20080505231135.6B4398430 at lock.gotdns.org>
>
> I would think it would help to rename https://wiki.ubuntu.com/SpecSpec
> to SpecTemplate so it would show up as an option when creating specs -
> see e.g. https://wiki.ubuntu.com/HelpOnPageCreation Any objections?
> Of course links to it from other pages would need to be redirected
> there via #redirect, and/or fixed....
>
> Also, the server team recommends deleting
> https://help.ubuntu.com/community/MailScanner - should I go ahead, or
> put it in some sort of CategoryDeletion or what?
>
> Neal McBurnett http://mcburnett.org/neal/
>
>
>
> ------------------------------
>
> Message: 3
> Date: Mon, 5 May 2008 20:48:37 -0400
> From: "Adam Sommer" <asommer70 at gmail.com>
> Subject: Re: [RFC] Ubuntu Manpages Website
> To: "Dustin Kirkland" <kirkland at canonical.com>
> Cc: ubuntu-doc at lists.ubuntu.com
> Message-ID:
> <2062c0d40805051748h74139604o33845d81037afc86 at mail.gmail.com>
> Content-Type: text/plain; charset="iso-8859-1"
>
> Hello,
>
>
> > I'm aware of http://manpages.debian.net and
> > http://www.linuxmanpages.com, however neither of these are dedicated
> > to the particular packages nor versions included in Ubuntu. I feel
> > that this is an important piece of documentation missing from the
> > publications on http://help.ubuntu.com. Please let me know if this
> > information currently exists.
>
>
> I'm not aware of any similar effort specific to Ubuntu. I think this is a
> great idea! I think being able to search Ubuntu manpages will add more
> depth to the current documentation.
>
> --
> Party On,
> Adam
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080505/9a0d7abd/attachment-0001.htm
>
> ------------------------------
>
> Message: 4
> Date: Tue, 6 May 2008 07:40:56 +0100
> From: "Matthew East" <mdke at ubuntu.com>
> Subject: Re: SpecSpec => SpecTemplate?
> To: "Neal McBurnett" <neal at bcn.boulder.co.us>
> Cc: ubuntu-doc <ubuntu-doc at lists.ubuntu.com>
> Message-ID:
> <3bd91160805052340x7494100bx7027a1f4800bfecc at mail.gmail.com>
> Content-Type: text/plain; charset=UTF-8
>
> Hi,
>
> On Tue, May 6, 2008 at 12:11 AM, Neal McBurnett <neal at bcn.boulder.co.us>
> wrote:
> > I would think it would help to rename https://wiki.ubuntu.com/SpecSpec
> > to SpecTemplate so it would show up as an option when creating specs -
> > see e.g. https://wiki.ubuntu.com/HelpOnPageCreation Any objections?
> > Of course links to it from other pages would need to be redirected
> > there via #redirect, and/or fixed....
>
> You need to liaise with the development team about this.
>
> > Also, the server team recommends deleting
> > https://help.ubuntu.com/community/MailScanner - should I go ahead, or
> > put it in some sort of CategoryDeletion or what?
>
> We don't current have a category for such pages, although it sounds
> like a good idea. Go ahead and create one!
>
> --
> Matthew East
> http://www.mdke.org
> gnupg pub 1024D/0E6B06FF
>
>
>
> ------------------------------
>
> Message: 5
> Date: Tue, 06 May 2008 10:10:22 +0100
> From: Phil Bull <philbull at gmail.com>
> Subject: Re: Tech-review report of web-apps.xml ...
> To: Vignesh <vigneshacitizenofindia at yahoo.co.in>
> Cc: ubuntu-doc at lists.ubuntu.com
> Message-ID: <1210065022.12163.38.camel at jaguar>
> Content-Type: text/plain
>
> Hi Vignesh,
>
> On Fri, 2008-05-02 at 22:57 +0530, Vignesh wrote:
> > Tech-review report of web-apps.xml ...
> >
> > *Under "Get plugins for your web browser",
> > -> "A plugin is a small program which extends the capabilities of
> > another program." ==> "A plugin is a small program which extends the
> > capabilities of an existing program." (Better definition for a plugin)
> >
> > -> to "run small, web-based programs." ==> "to run small web-based
> > programs." (Removed unnecessary comma).
> >
> > *Under "Quickly install common plugins",
> > -> "Check that you are allowed to use this software before installing
> > it." ==> "Make sure that you are allowed to use this software before
> > installing it." (on account of better english)
> >
> > -> "Many different multimedia formats are used on the Internet, and so
> > you may find that you are unable to play some audio and video files
> > without first installing an appropriate plugin." ==> "Many different
> > multimedia formats are used on the Internet and you may find that you
> > are unable to play some audio and video files without installing an
> > appropriate plugin." (on account of more formal and better english)
>
> All of the above changes look sensible.
>
> > *Under "Flash multimedia plugin",
> > -> The following paragraph seems to be creating confusion for
> > beginners..
> > "Installing the package as described above will download and
> > install the plugin. You need an Internet connection for this to work.
> > If, after installing the application, you need to download and install
> > the plugin at a later time, enter the following command in a terminal:
> > sudo dpkg-reconfigure flashplugin-nonfree"
> > (I feel that the entire paragraph should be re-written in a better way
> > so that a beginner can understand)
>
> I agree. Maybe something like:
>
> "A copy of the Flash plugin is not actually included in the package, but
> is automatically downloaded from the Adobe website when you install the
> package. This is due to legal restrictions on the redistribution of the
> plugin. As a result, you must be connected to the Internet for the
> plugin to be downloaded successfully."
>
> I don't think we need the bit on reinstalling the plugin because the
> normal method of reinstalling packages should work.
>
> > -> Only Blufish editor has been mentioned. Other editors that can be
> > mentioned are, "Screem HTML/XML Editor" and the good old "GEdit". If
> > you think these two deserve a place in there, please let me know. I am
> > interested in writing the guides for using those two.
>
> Most of the "web-apps" section just points to different software
> packages nowadays. I'm wondering if we shouldn't condense it down into
> just two sections:
>
> * Recommended web software: just a short list, with recommended
> apps for each common web task
> * Browser plugins: Brief instructions on installing plugins and
> helper apps (like RealPlayer)
>
> What are your thoughts on this?
>
> Thanks,
>
> Phil
>
> --
> Phil Bull
> http://www.launchpad.net/people/philbull
>
>
>
>
> ------------------------------
>
> Message: 6
> Date: Tue, 06 May 2008 10:19:27 +0100
> From: Phil Bull <philbull at gmail.com>
> Subject: Re: Contributers
> To: Dougie Richardson <ddrichardson at btinternet.com>
> Cc: Ubuntu Doc Team <ubuntu-doc at lists.ubuntu.com>
> Message-ID: <1210065567.12163.47.camel at jaguar>
> Content-Type: text/plain; charset=utf-8
>
> Hi Dougie,
>
> On Thu, 2008-05-01 at 22:32 +0100, Dougie Richardson wrote:
> > I was looking through contributors.xml [1] and was thinking it no longer
> > reflects the make up of the team since moving to commiters and students.
> >
> > Thoughts:
> > - Could it be organised by specific areas, e.g server guide?
> > - Split into students and committers?
> > - Include a little information on joining and contributing?
> > - Specific contacts (maybe - I mean the list is the best way but for
> > those on the team I often forget who specialises in what)?
> >
> > I know this is a bit of a wish list type thing but early in the cycle
> > would seem to be the time to discuss a format.
> [...]
> > [1] libs/C/?contributors.xml
>
> I don't think that the entire list needs to be organised by area (a lot
> of people contribute to more than one area), although it would
> definitely be useful to have a contact for each of the specific areas as
> you say. This would just be someone who is familiar with that area and
> knows what direction it's going in.
>
> Splitting into students and committers is a bit artificial I think. I'd
> be happy just to see an alphabetised list.
>
> Some information for people who want to contribute would also be great,
> and it doesn't need to be much more than a sentence with a link to our
> wiki page.
>
> Thanks,
>
> Phil
>
> --
> Phil Bull
> http://www.launchpad.net/people/philbull
>
>
>
>
> ------------------------------
>
> Message: 7
> Date: Tue, 06 May 2008 10:42:48 +0100
> From: Phil Bull <philbull at gmail.com>
> Subject: Re: I'd like to get involved.
> To: Ricardo Mesa Curtido <rimescu at gmail.com>
> Cc: ubuntu-doc at lists.ubuntu.com
> Message-ID: <1210066968.12163.58.camel at jaguar>
> Content-Type: text/plain
>
> Hi Ricardo,
>
> On Mon, 2008-05-05 at 12:59 +0200, Ricardo Mesa Curtido wrote:
> > I'm Ricardo, from Spain, and I'd like to collaborate.
> > After a few years using SuSE I discoverded Ubuntu (in 2005! Breezy
> > Badger! I can't believe how fast time goes by! :-)
> >
> > Well. I'm using Gnome desktop and rigth now I'm upgrading to 8.04 and
> > I think it's a good moment to give a new step. I'd like to collaborate
> > with the Ubuntu Community. Please, tell me how can I help. I'm
> > interested in technical reviewing and inexistent documentation. It's
> > annoying/frustrating to press a help button and get a white box, or a
> > non-existant box, when the help button exists! :-) I can also
> > translate texts into spanish.
>
> Welcome! Have you read our wiki page on technical reviewing [1]? If so,
> would you be interested in technical reviewing some of the GNOME
> documentation?
>
> Thanks,
>
> Phil
>
> [1] - https://wiki.ubuntu.com/DocumentationTeam/TechReview
>
> --
> Phil Bull
> http://www.launchpad.net/people/philbull
>
>
>
>
> ------------------------------
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
>
> End of ubuntu-doc Digest, Vol 44, Issue 7
> *****************************************
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080506/d3d1da56/attachment.html>
More information about the ubuntu-doc
mailing list