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. <div class="gmail_quote">On Tue, May 6, 2008 at 4:00 AM, <<a href="mailto:ubuntu-doc-request@lists.ubuntu.com">ubuntu-doc-request@lists.ubuntu.com</a>> wrote: <blockquote class="gmail_quote" style="PADDING-LEFT: 1ex; MARGIN: 0px 0px 0px 0.8ex; BORDER-LEFT: #ccc 1px solid">Send ubuntu-doc mailing list submissions to <a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a> To subscribe or unsubscribe via the World Wide Web, visit <a href="https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc" target="_blank">https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc</a> or, via email, send a message with subject or body 'help' to <a href="mailto:ubuntu-doc-request@lists.ubuntu.com">ubuntu-doc-request@lists.ubuntu.com</a> You can reach the person managing the list at <a href="mailto:ubuntu-doc-owner@lists.ubuntu.com">ubuntu-doc-owner@lists.ubuntu.com</a> 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" <<a href="mailto:kirkland@canonical.com">kirkland@canonical.com</a>> Subject: [RFC] Ubuntu Manpages Website To: <a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a> Message-ID: <<a href="mailto:d9c105ea0805051413u6986ddb5j6a8af31c20c3aa2d@mail.gmail.com">d9c105ea0805051413u6986ddb5j6a8af31c20c3aa2d@mail.gmail.com</a>> 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. <a href="https://blueprints.launchpad.net/ubuntu-doc/+spec/ubuntu-manpage-website/" target="_blank">https://blueprints.launchpad.net/ubuntu-doc/+spec/ubuntu-manpage-website/</a> I'm aware of <a href="http://manpages.debian.net/" target="_blank">http://manpages.debian.net</a> and <a href="http://www.linuxmanpages.com/" target="_blank">http://www.linuxmanpages.com</a>, 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 <a href="http://help.ubuntu.com/" target="_blank">http://help.ubuntu.com</a>. Please let me know if this information currently exists. I'm proposing a section of the Ubuntu documentation, perhaps <a href="http://help.ubuntu.com/manpages" target="_blank">http://help.ubuntu.com/manpages</a> dedicated to this purpose. I have a working prototype temporarily at <a href="http://ubuntu.dustinkirkland.com/manpages" target="_blank">http://ubuntu.dustinkirkland.com/manpages</a> 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 <<a href="mailto:neal@bcn.boulder.co.us">neal@bcn.boulder.co.us</a>> Subject: SpecSpec => SpecTemplate? To: ubuntu-doc <<a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a>> Message-ID: <<a href="mailto:20080505231135.6B4398430@lock.gotdns.org">20080505231135.6B4398430@lock.gotdns.org</a>> I would think it would help to rename <a href="https://wiki.ubuntu.com/SpecSpec" target="_blank">https://wiki.ubuntu.com/SpecSpec</a> to SpecTemplate so it would show up as an option when creating specs - see e.g. <a href="https://wiki.ubuntu.com/HelpOnPageCreation" target="_blank">https://wiki.ubuntu.com/HelpOnPageCreation</a> 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 <a href="https://help.ubuntu.com/community/MailScanner" target="_blank">https://help.ubuntu.com/community/MailScanner</a> - should I go ahead, or put it in some sort of CategoryDeletion or what? Neal McBurnett <a href="http://mcburnett.org/neal/" target="_blank">http://mcburnett.org/neal/</a> ------------------------------ Message: 3 Date: Mon, 5 May 2008 20:48:37 -0400 From: "Adam Sommer" <<a href="mailto:asommer70@gmail.com">asommer70@gmail.com</a>> Subject: Re: [RFC] Ubuntu Manpages Website To: "Dustin Kirkland" <<a href="mailto:kirkland@canonical.com">kirkland@canonical.com</a>> Cc: <a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a> Message-ID: <<a href="mailto:2062c0d40805051748h74139604o33845d81037afc86@mail.gmail.com">2062c0d40805051748h74139604o33845d81037afc86@mail.gmail.com</a>> Content-Type: text/plain; charset="iso-8859-1" Hello, > I'm aware of <a href="http://manpages.debian.net/" target="_blank">http://manpages.debian.net</a> and > <a href="http://www.linuxmanpages.com/" target="_blank">http://www.linuxmanpages.com</a>, 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 <a href="http://help.ubuntu.com/" target="_blank">http://help.ubuntu.com</a>. 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: <a href="https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080505/9a0d7abd/attachment-0001.htm" target="_blank">https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080505/9a0d7abd/attachment-0001.htm</a> ------------------------------ Message: 4 Date: Tue, 6 May 2008 07:40:56 +0100 From: "Matthew East" <<a href="mailto:mdke@ubuntu.com">mdke@ubuntu.com</a>> Subject: Re: SpecSpec => SpecTemplate? To: "Neal McBurnett" <<a href="mailto:neal@bcn.boulder.co.us">neal@bcn.boulder.co.us</a>> Cc: ubuntu-doc <<a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a>> Message-ID: <<a href="mailto:3bd91160805052340x7494100bx7027a1f4800bfecc@mail.gmail.com">3bd91160805052340x7494100bx7027a1f4800bfecc@mail.gmail.com</a>> Content-Type: text/plain; charset=UTF-8 Hi, On Tue, May 6, 2008 at 12:11 AM, Neal McBurnett <<a href="mailto:neal@bcn.boulder.co.us">neal@bcn.boulder.co.us</a>> wrote: > I would think it would help to rename <a href="https://wiki.ubuntu.com/SpecSpec" target="_blank">https://wiki.ubuntu.com/SpecSpec</a> > to SpecTemplate so it would show up as an option when creating specs - > see e.g. <a href="https://wiki.ubuntu.com/HelpOnPageCreation" target="_blank">https://wiki.ubuntu.com/HelpOnPageCreation</a> 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 > <a href="https://help.ubuntu.com/community/MailScanner" target="_blank">https://help.ubuntu.com/community/MailScanner</a> - 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 <a href="http://www.mdke.org/" target="_blank">http://www.mdke.org</a> gnupg pub 1024D/0E6B06FF ------------------------------ Message: 5 Date: Tue, 06 May 2008 10:10:22 +0100 From: Phil Bull <<a href="mailto:philbull@gmail.com">philbull@gmail.com</a>> Subject: Re: Tech-review report of web-apps.xml ... To: Vignesh <<a href="mailto:vigneshacitizenofindia@yahoo.co.in">vigneshacitizenofindia@yahoo.co.in</a>> Cc: <a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a> Message-ID: <1210065022.12163.38.camel@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 <a href="http://www.launchpad.net/people/philbull" target="_blank">http://www.launchpad.net/people/philbull</a> ------------------------------ Message: 6 Date: Tue, 06 May 2008 10:19:27 +0100 From: Phil Bull <<a href="mailto:philbull@gmail.com">philbull@gmail.com</a>> Subject: Re: Contributers To: Dougie Richardson <<a href="mailto:ddrichardson@btinternet.com">ddrichardson@btinternet.com</a>> Cc: Ubuntu Doc Team <<a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a>> Message-ID: <1210065567.12163.47.camel@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 <a href="http://www.launchpad.net/people/philbull" target="_blank">http://www.launchpad.net/people/philbull</a> ------------------------------ Message: 7 Date: Tue, 06 May 2008 10:42:48 +0100 From: Phil Bull <<a href="mailto:philbull@gmail.com">philbull@gmail.com</a>> Subject: Re: I'd like to get involved. To: Ricardo Mesa Curtido <<a href="mailto:rimescu@gmail.com">rimescu@gmail.com</a>> Cc: <a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a> Message-ID: <1210066968.12163.58.camel@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] - <a href="https://wiki.ubuntu.com/DocumentationTeam/TechReview" target="_blank">https://wiki.ubuntu.com/DocumentationTeam/TechReview</a> -- Phil Bull <a href="http://www.launchpad.net/people/philbull" target="_blank">http://www.launchpad.net/people/philbull</a> ------------------------------ -- ubuntu-doc mailing list <a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a> <a href="https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc" target="_blank">https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc</a> End of ubuntu-doc Digest, Vol 44, Issue 7 ***************************************** </blockquote></div>