edit-tips.html errata
Justin B Rye
jbr at edlug.org.uk
Sat Dec 9 11:56:18 CET 2006
Patch to the HTML attached, annotated "patch" of the dumped version
inlined. Okay, I should probably be going through svn, but bear in
mind that I can't tell one end of a version control system from
another.
I haven't touched the culture::* tip. But if culture::italian means
spellchecker-localisation packages such as witalian etc (rather than
meaning that an app comes with Italian error messages, manpages and
so on), why then is there still no tag for wbritish?
- * Short of ideas? Let the tag search suggest you.
+ * Short of ideas? Let the tag search give you a hint.
The object of "suggest" is the suggestion, not the suggestee.
- Contrarily to most other facets in Debtags, the Role facet is designed to
+ Contrary to most other facets in Debtags, the Role facet is designed to
The adjective "contrary" can mean either "opposite" or "habitually
perverse", but the two senses are associated with distinct adverb
forms.
- * Every software should be implemented in one or more languages.
+ * Every piece of software should be implemented in one or more languages.
"Software" is a mass noun, not a countable noun.
- applies to most of its code. However, tt is often hard to know what
+ applies to most of its code. However, it is often hard to know what
Trivial typo.
- Take perl, for example: it's devel::lang:perl, but it is implemented-in::c.
+ Take lua5.1, for example: it's devel::lang:lua, but it is implemented-in::c.
Perl is a poor example of something "implemented in C" since the
package of that name is made up of scripts, .pm/.al/.ph files etc.
Yes, the Perl 5 interpreter is implemented-in::c, but /usr/bin/perl
is in perl-base! The package lua5.1 on the other hand actually
contains the interpreter and compiler binaries for that language,
and is a clear case of devel::lang: versus implemented-in::.
- Take for example k3b and k3b-i18n: the former package contain a very good
- software to create CDs and DVDs. The latter package does not contain
+ Take for example k3b and k3b-i18n: the former package contains a very good
+ application to create CDs and DVDs. The latter package does not contain
A number-agreement typo, plus the software problem as above.
- There are non-software packages in Debian to create a new set of
- categories. For those few other packages, like anarchism, bible-kjv-text,
- c++-annotations, cfi-en, diveintopython, hwb, newbyedoc, use role::data.
+ There are some data packages in Debian that don't fit the category of
+ "application data". For those few other packages, like anarchism,
+ bible-kjv-text, or cfi-en, use role::data.
I'm not sure I follow the first sentence, so I've replaced it with
something completely different that says what I'd have said in this
context. Then, the package c++-annotations isn't role::data, it's a
role::dummy metapackage; and the things it depends on look to me
like role::documentation. Let's stick to the clear examples.
--
JBR Ankh kak!
(Ancient Egyptian blessing)
-------------- next part --------------
--- edit-tips.html.orig 2006-12-08 23:41:13.000000000 +0000
+++ edit-tips.html 2006-12-08 23:48:50.000000000 +0000
@@ -26,7 +26,7 @@
<ul>
<li>
- <p><i>Short of ideas? Let the tag search suggest you.</i></p>
+ <p><i>Short of ideas? Let the tag search give you a hint.</i></p>
<p>If you want to represent a concept but you do not know how, choose "Tag
search" and try looking for that concept just like you would look for it on
Google. In many cases you will get a useful tag suggestion for it.
@@ -34,17 +34,17 @@
</li>
<li>
<p><i>Every package should have a role.</i></p>
- <p>Contrarily to most other facets in Debtags, the Role facet is designed to
- be applicable to all packages in Debian.</p>
+ <p>Contrary to most other facets in Debtags, the Role facet is designed to be
+ applicable to all packages in Debian.</p>
<p>Try to find a suitable role for the package you are tagging. If you think
that there is no applicable role, use the tag <tt>role::TODO</tt> to mark a
possible gap in the tag vocabulary.
</p>
</li>
<li>
- <p><i>Every software should be implemented in one or more languages.</i></p>
+ <p><i>Every piece of software should be implemented in one or more languages.</i></p>
<p>For all software in Debian, there should be an <tt>implemented-in::*</tt>
- tag that applies to most of its code. However, tt is often hard to know what
+ tag that applies to most of its code. However, it is often hard to know what
<tt>implemented-in::*</tt> tag to use without looking at the source of a
package.</p>
<p>If you are the maintainer of the package, or have looked at its source
@@ -54,14 +54,14 @@
</li>
<li>
<p><i><tt>devel::lang:*</tt> and <tt>implemented-in::*</tt> are different.</i></p>
- <p>Take perl, for example: it's <tt>devel::lang:perl</tt>, but it is
+ <p>Take lua5.1, for example: it's <tt>devel::lang:lua</tt>, but it is
<tt>implemented-in::c</tt>.</p>
</li>
<li>
<p><i>If the name is similar, the tags may not be.</i></p>
<p>Take for example <tt>k3b</tt> and <tt>k3b-i18n</tt>: the former package
- contain a very good software to create CDs and DVDs. The latter package does
- not contain software, but data files containing translated strings.</p>
+ contains a very good application to create CDs and DVDs. The latter package
+ does not contain software, but data files containing translated strings.</p>
<p><tt>role::app-data</tt> is a good tag for <tt>k3b-i18n</tt>. You should
not tag <tt>k3b-i18n</tt> as <tt>x11::application</tt>, because it does not
contain any X11 application.</p>
@@ -77,10 +77,9 @@
<p>Most of the data packages in Debian are things like arch-independent support
packages for arch-dependent software, which one normally would not want to
see as the result of a package search.</p>
- <p>There are non-software packages in Debian to create a new set of
- categories. For those few other packages, like anarchism, bible-kjv-text,
- c++-annotations, cfi-en, diveintopython, hwb, newbyedoc, use
- <tt>role::data</tt>.</p>
+ <p>There are some data packages in Debian that don't fit the category of
+ "application data". For those few other packages, like anarchism,
+ bible-kjv-text, or cfi-en, use <tt>role::data</tt>.</p>
</li>
<li><p><i>culture::* tags are for culture-specific packages.</i></p>
<p>Use <tt>culture::*</tt> tags to mark only those packages that are
More information about the Debtags-devel
mailing list