Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread Patrick Dickey
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I would say that we should use it for all of the "major" applications. I wouldn't use it for anything on the launcher, except maybe things that are Canonical (or Ubuntu) related -- like Ubuntu Settings and Ubuntu One, but not necessarily for Libre-*.

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread c7p
Then, I can work through adding \index tags. > > -MarioB > --Original Message-- > From: Kevin Godby > To: Mario Burgos > Cc: ubuntu-manual-bounces+mario=petrielabs@lists.launchpad.net > Cc: lafeber-dumoleyn2 > Cc: ubuntu-manual > Subject: Re: [Ubuntu-manual] \applic

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread Kevin Godby
On Thu, Nov 17, 2011 at 4:20 PM, wrote: > Totally. I'll start reading over the manual and taking notes on terms to add > to the index and glossary. Then, I can work through adding \index tags. Excellent! I hereby appoint you as our indexer. When you're ready to start adding code to the documen

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread mario
d.net Cc: lafeber-dumoleyn2 Cc: ubuntu-manual Subject: Re: [Ubuntu-manual] \application{}, yes or no Sent: Nov 17, 2011 2:16 PM Hello, Mario. On Thu, Nov 17, 2011 at 4:10 PM, wrote: > Totally agree. > \application should only format (if anything), and we should use \index for > terms

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread Kevin Godby
Hello, Mario. On Thu, Nov 17, 2011 at 4:10 PM, wrote: > Totally agree. > \application should only format (if anything), and we should use \index for > terms to be indexed. > >  I've got my copy of "Indexing: A Nuts-ans-Bolts Guide for Technical Writers" > in my hands. Awesome. Would you like

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread mario
om: Kevin Godby Sender: ubuntu-manual-bounces+mario=petrielabs@lists.launchpad.net Date: Thu, 17 Nov 2011 16:02:41 To: lafeber-dumoleyn2 Cc: ubuntu-manual Subject: Re: [Ubuntu-manual] \application{}, yes or no On Thu, Nov 17, 2011 at 2:53 AM, lafeber-dumoleyn2 wrote: > I wonder if we s

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread Kevin Godby
On Thu, Nov 17, 2011 at 2:53 AM, lafeber-dumoleyn2 wrote: > I wonder if we should add the code \application{} every time we come upon > the name of an application. I understand that by adding the code the page > number will be added to the name in the index. But we do not want the index > to be cr

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread Rick Fosburgh
IMO: The use should be limited (so as to make the index useful). I would agree with John that it should be limited to the section that describes the application (if there is one), and then only in sections where the application is integral to the topic at hand. I suspect we need to review the in

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread Bob Bolin
Agree with Thomas, index will be useless if we overuse the reference. On Thu, Nov 17, 2011 at 7:56 AM, tom.swart...@gmail.com < tom.swart...@gmail.com> wrote: > I agree, if you use it on every instance, the index will be almost as big > as the text portion of the manual. haha. > > I figure it sho

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread tom.swart...@gmail.com
I agree, if you use it on every instance, the index will be almost as big as the text portion of the manual. haha. I figure it should be used with a little thought behind it. If the instance is referencing a feature or option that might not be discussed in an other section of the manual, then it s

Re: [Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread c7p
We shouldn't use the code on every app name we find for sure. I guess we should use the code on apps that are relevant to the section they are in. I'm not sure though, what do you think guys ? --John 2011/11/17 lafeber-dumoleyn2 > ** > I wonder if we should add the code \application{} every tim

[Ubuntu-manual] \application{}, yes or no

2011-11-17 Thread lafeber-dumoleyn2
I wonder if we should add the code \application{} every time we come upon the name of an application. I understand that by adding the code the page number will be added to the name in the index. But we do not want the index to be crammed with page numbers, do we? Is it up to the author/editor to de