← Back to team overview

ubuntu-manual team mailing list archive

Re: \application{}, yes or no

 

Agree with Thomas, index will be useless if we overuse the reference.

On Thu, Nov 17, 2011 at 7:56 AM, tom.swartz07@xxxxxxxxx <
tom.swartz07@xxxxxxxxx> 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 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 should use the \application
> reference. If it's just a passing comment or ancillary mention of the
> software, then skip it.
>
> Thats just my two pence.
>
>
> Thomas Swartz
>
> No trees were killed to send this message, but a large number of electrons
> were terribly inconvenienced.
>
>
> On Thu, Nov 17, 2011 at 7:04 AM, c7p <c7p.admin@xxxxxxxxx> wrote:
>
>> 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 <lafeber-dumoleyn2@xxxxxxxxx>
>>
>>>  **
>>> 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 decide whether the code should be added
>>> or not?
>>> Hannie
>>>
>>> _______________________________________________
>>> 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
>>>
>>>
>>
>> _______________________________________________
>> 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
>>
>>
>
> _______________________________________________
> 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
>
>


-- 
Cheers,

Bob Bolin

References