I, too, agree the manual is written for the "newer" user. We target the "new" users as a majority while recognizing we attract users who may have played around with the previous version(s) and really want to dig into the current version.
Where applicable, I completely support omitting the rev number from the body of the manual, but if some peripheral distinction is deemed necessary by the author of a given section, then I would advocate a very limited use of the \marginnote tag for this information--and ONLY when an explanation of the progress/advancement from a previous rev to the current rev enhances the users' understanding of the content and/or concept. On Tue, Aug 13, 2013 at 1:10 AM, Kevin Godby <god...@gmail.com> wrote: > On Tue, Aug 13, 2013 at 1:47 AM, Hannie Dumoleyn > <lafeber-dumole...@zonnet.nl> wrote: > > To all authors and editors, > > I would suggest NOT to add the version number if it is not absolutely > > necessary. An example: > > The Ubuntu 13.10 Launcher on the left with a sample of applications on > it. > > I would prefer this: > > The Ubuntu Launcher on the left with a sample of applications on it. > > It is quite obvious that we are talking about the 13.10 Launcher in > Saucy. > > The advantage is that we do not need to make changes in this sentence in > > the future. > > What do you think? > > I agree. Unless you need to distinguish something that's specific to > 13.10, you shouldn't need to mention the version number. Also, the > manual is aimed at newer users and not those who have been using > Ubuntu for years. So even if a feature is relatively new, you don't > need to introduce it as being new. As far as readers of the 13.10 > manual are concerned (as they're using Ubuntu 13.10) the feature > exists; it doesn't matter when it was introduced. > > —Kevin > > _______________________________________________ > Mailing list: https://launchpad.net/~ubuntu-manual > Post to : ubuntu-manual@lists.launchpad.net > Unsubscribe : https://launchpad.net/~ubuntu-manual > More help : https://help.launchpad.net/ListHelp >
_______________________________________________ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
