Like the rest of Debian, the derivatives census needs some QA. This page aims to document common issues and provide templates to be sent when these issues are detected.

Issues

General ping

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: ping

Hi all,

If you are receiving this email you either added your derivative
distribution to the census or volunteered to maintain its census page.

The first thing I would like to bring up is contact information. It is
preferred that you add the "Debian derivatives census maintainer:" line
and set it to the name, email address and OFTC IRC nick of a human being
rather than an email list or role alias. If the maintainer is an IRC
user it is recommended that they join the #debian-derivatives channel on
OFTC so Debian folks can easily ask them questions. You as maintainer
will hopefully be prepared to answer any questions that result from my
article. In addition you should subscribe to your census page and the
CensusTemplate, either via Moin's email notification feature or via the
RecentChanges RSS feed so that you are notified of any changes to your
distributions census page or any changes that are recommended for it.

Many of the pages are incomplete. Each page should have the following at
minimum unless there is a good reason to remove them. It is strongly
recommended to fill out as much of the CensusTemplate as exists.

      * an introductory blurb about the goals of your Debian derivative
      * a logo so your distro is easily recognisable on the page
      * a website so people can read more info if they want
      * a email contactable human maintainer so Debian folks can ask you
        questions about your distribution.
      * apt repositories (both deb and deb-src) so Debian folks can take
        a look at your work. Preferably with architecture information.

As you may or may not be aware we have drafted some guidelines for
Debian derivatives on our wiki. If you have any comments or suggestions
about the guidelines we suggest that you bring them up on the
debian-derivatives mailing list.

http://wiki.debian.org/Derivatives/Guidelines

No source packages

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: potentially violating the GPL or LGPL due to lack of source code

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Please ensure that:

     1. You are not violating the GNU GPL or LGPL licences. This may be
        the case since you do not appear to be shipping the source code
        for GNU GPL or LGPL software but are definitely shipping
        binaries for such software.
     2. You are shipping Debian source packages alongside your Debian
        binary packages.
     3. Your Debian census entry has working deb-src lines in your apt
        sources.list snippet for each deb line.

In addition please make sure there is a contact point listed in the
maintainer field of your census page.

While you are editing your page, please fill in as much of the fields
from the template[2] as you have data for.

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/CensusTemplate
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives

General sources.list issues

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: apt sources.list snippet
Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Please ensure that:

     1. Your entry contains a sources.list like the one shown in the
        census template[2].
     2. Your entry's sources.list contains deb-src lines for each deb
        line.
     3. Your entry's sources.list works when running apt-get update.
     4. Your APT repositories have SHA-1 hashes for every source and
        binary package so we can compare with old Debian packages.
     5. If you are using SHA-1 hashes in your APT repositories,
        please ensure that there is such a hash for every single
        file, especially for all the source package files.
     6. SHA-256 hashes are not and will not be used by the census, but
        Debian strongly encourages the use of hashes stronger than SHA-1.

In addition please make sure there is a contact point listed in the
maintainer field of your census page.

While you are editing your page, please fill in as much of the fields as
you have data for.

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/CensusTemplate
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives

Errors from apt-get update

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: errors from apt sources.list

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Please ensure that your entry's sources.list does not generate any
errors when someone runs apt-get/aptitude update on it. You can test it
locally using these commands and watching for any errors or warnings.
If you get any GPG warnings, that is fine since our scripts explicitly
ignore any such warnings since it is a very long-term project to establish
trust paths between Debian and our derivatives.

mkdir test
cd test
mkdir partial
edit sources.list # Paste your sources.list here
aptitude update -q=0 -y \
        -o "Dir::Etc::SourceList=`pwd`/sources.list" \
        -o "Dir::Etc::SourceParts=`pwd`" \
        -o "Dir::State::Lists=`pwd`" \
        -o "Debug::NoLocking=1" -o "Debug::pkgDPkgPM=1" 

You can find an example of a correct sources.list file in the census
template wiki page[2].

While you are editing your page, please fill in as much of the fields as
you have data for.
Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census 
     2. http://wiki.debian.org/Derivatives/CensusTemplate 
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives

Modifying binary packages?

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: modifying binary packages?

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Your census page indicates that your distribution takes binary packages
from Debian and modifies them instead of just modifying the Debian
source package and rebuilding it to produce new binary packages. I
wonder if that is actually the case or if you actually practice that
strange way of doing things?

In addition please make sure there is a contact point listed in the
maintainer field of your census page.

While you are editing your page, please fill in as much of the fields
from the template[2] as you have data for.

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/CensusTemplate
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives

Blogs

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: blogs

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Please ensure that:

     1. If your derivative has a blog or news page, it is listed in your
        census entry.
     2. If your derivative's developers have blogs, you have a feed
        aggregator for them or have listed the blogs separately in your
        census entry.
     3. All of the blog URLs you add have RSS/Atom feeds that are
        discoverable using the RSS/Atom autodiscovery mechanisms[5].
        Almost every wiki, blog and CMS out there supports feeds and
        feed autodiscovery mechanisms so you might already have this,
        please double check though.
     4. Your blogs have some content and that you intend to add more.
     5. If possible, please list the English versions of your blogs.
     6. Your logo image is available over plain HTTP and is not too big.

If your derivative doesn't have a blog you might consider starting one
to help promote your derivative, announce new releases and inform users
about any important changes made during development. 

Any blogs that have discoverable RSS feeds will be added to the new
Planet Debian derivatives[6].

In addition please make sure there is a contact point listed in the
maintainer field of your census page.

While you are editing your page, please fill in as much of the fields
from the template[2] as you have data for.

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/CensusTemplate
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives
     5. http://www.rssboard.org/rss-autodiscovery
     6. http://planet.debian.org/deriv/

Description issues

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: description issues

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Please ensure that:

     1. Your entry has a description of your Debian derivative
     2. Your derivative's description is accurate and useful to members
        and users of Debian members. Don't use your standard marketing
        language, describe the value that you add to Debian.

In addition please make sure there is a contact point listed in the
maintainer field of your census page.

While you are editing your page, please fill in as much of the fields as
you have data for.

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/CensusTemplate
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives

Logo issues

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: logo broken or missing

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that your entry has an issue.

Please ensure that:

     1. Your entry has a logo
     2. The logo URL is downloadable
     3. The logo URL returns an image, not HTML or anything else

In addition please make sure there is a contact point listed in the
maintainer field of your census page.

While you are editing your page, please fill in as much of the fields as
you have data for.

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/CensusTemplate
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives

Opportunities

To: debian-derivatives@lists.debian.org
Subject: Debian derivatives census: bug links on the Debian wiki

Hi all,

If you are receiving this mail that means you are participating in the
Debian derivatives census[1] and that there is an opportunity for
greater integration[2] with Debian infrastructure.

The Debian wiki has some JavaScript that checks the status of Debian
bugs and changes the CSS to indicate if the bug was closed or not and
give the bug a mouse-over title indicating bug title, fixed versions and
so on.

We would like to extend this support to the bug trackers of Debian
derivatives where possible. Your Debian derivatives census entry seems
to contain a bug tracker link for your derivative. If you are using the
Debian wiki, linking from it to your bug tracker and your bug tracker
has some sort of machine-readable API, you might want us to work on
adding support for it to the Debian wiki. If you don't want that, please
ignore this email and sorry for the noise. If you do want that and have
a machine-readable API for your bug tracker, please reply to this email
and we will attempt to add support for it. If you don't have a
machine-readable API then we are also happy to add support for short
interwiki links to your bug pages, check out[5] if so and then edit [6]
and you may also want to get your InterWiki shortcuts into the MoinMoin
master list at [7].

Please direct any questions you have to the derivatives list[3] or IRC
channel[4]. We strongly encourage you to join both of these.

     1. http://wiki.debian.org/Derivatives/Census
     2. http://wiki.debian.org/Derivatives/Integration
     3. http://lists.debian.org/debian-derivatives
     4. irc://irc.oftc.net/debian-derivatives
     5. http://wiki.debian.org/InterWiki
     6. http://wiki.debian.org/InterWikiMap
     7. http://master.moinmo.in/InterWikiMap