help-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [help-texinfo] Newbie seeks feedback on a Texinfo learning project


From: Thien-Thi Nguyen
Subject: Re: [help-texinfo] Newbie seeks feedback on a Texinfo learning project
Date: Sat, 17 Sep 2016 11:35:18 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux)

() Eli Zaretskii <address@hidden>
() Fri, 16 Sep 2016 17:06:35 +0300

    . Also try to avoid closely located index entries that begin
      the same, like this:

       @cindex How to Download a RedHat Package
       @cindex How to Download a Fedora Package

      Instead, either make a single index entry, or remove the
      "How to Download" from the entries.

Another approach: Move the general bit after the specific bit.
For example:

 @cindex RedHat Package, How to Download
 @cindex Fedora Package, How to Download

Personally, i'd go one step further and use a gerund:

 @cindex RedHat package, downloading
 @cindex Fedora package, downloading

(This example also shows downcased non-proper-noun words.)

-- 
Thien-Thi Nguyen -----------------------------------------------
 (defun responsep (type via)
   (case type
     (technical (eq 'mailing-list via))
     ...))                              748E A0E8 1CB8 A748 9BFA
--------------------------------------- 6CE4 6703 2224 4C80 7502

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]