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.
Contents
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
Bug links on the wiki
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