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