- General considerations
- FAQ (some sort of)
- Maintenance notes
- Other planets
Can I Be On Planet?
Planet Debian is for any active and directly involved participant in the Debian community. Inclusion in Planet should reflect a relationship that already exists -- it is not meant to create one. Inclusion is not restricted to people who are currently Debian members nor are ex-members necessarily barred from inclusion.
Defining activity and direct involvement is tough and there are many ways of participating in Debian (e.g., packaging, translations, administration, etc). We are happy to consider all of these types of involvement for the purposes of inclusion in Planet. In terms of deciding what is enough activity, we are daunted by the fact that there has been academic research on the difficulties of deciding what an active member of the Debian community is. As a result we will continue to rely primarily on what blog owners themselves feel unless the evidence available to us points to the contrary.
Planet participants should include feeds that provide stable permanent URLs so that they do not flood planet repeatedly and should include content in English only. An inability to do either of these will be grounds for exclusion from Planet until this can be fixed. (There are planets of other languages available if you do want to write in one of those languages.)
What Can I Post On Planet
What Can I Post On Planet?
Planet Debian aims to aggregate the blog posts of people who are active in Debian and not only to aggregate the blog posts about Debian. The point is to provide a window into the community itself. Posts that are about Debian are a great idea and some people will choose to only syndicate "on topic" posts. But other posts are also welcome! We want to learn about the people, their life, opinions (even political) and doings.
There are a few simple rules about content on Planet Debian:
Debian's community standards fully apply to Planet Debian, that includes following Debian's Code of Conduct.
Provide individual feeds for each language you post in. The main language for Planet is English.1
- Try not to annoy people. While there is absolutely no requirement that posts need to be about Debian, if there are a subset of posts that are annoying a large number of people and generating many complaints, you may be asked to consider providing a feed without the posts in question. If you stay away from advertising content (or content that might be confused as such) and from excessively personal information, you should be fine. Please also try to keep the very diverse readership of Planet Debian in mind, stuff which you think is fine could be offensive to others. Remember: try not to annoy people.
Be very careful including material from external sites (ie, not your own blog/domain). The occasional picture from elsewhere is fine, but anything that can be (or is) used to track reader's behavior (commonly called webbugs2) is considered bad and grounds for exclusion from Planet. If you regularly need external content, consider providing that from your own site.
- Avoid posting personal fights, insults or slurs. Planet Debian is not an appropriate medium for this.
- Posts that are syndicated on Planet Debian that violate our community standards may result in removal of the feed. When a feed is removed, the committer must state the reason for removal, either in a commit message or in the edited file (be mindful of the fact that the contents of commit messages cannot be expunged later; it is best to avoid specific details). If unsure, please contact the planet administrators instead of re-adding a feed yourself.
1 There are Planets in other languages. Should yours not yet have one, mail email@example.com and ask for one. Have 5 people with you to join the new Planet and it will get created.
2 Feedburner, Google adwhatever/analytics, etc.
How do I add myself to Planet?
Any contributor may add, amend or remove their own blog entry from Planet Debian. To do so, they must have an account at https://salsa.debian.org and be a Debian member or be a member of the planet-team/config project.
If you already have a Salsa account and are already a member of the project or are a Debian member, simply do the following:
git clone firstname.lastname@example.org:planet-team/config.git cd config vi config.ini Entries should be in alphabetical order at the bottom of the file and look like this: [https://url.to/your/feed] name = Your Name git commit -m "add/edit/remove Your Name" config.ini
If you're advocating, sponsoring, helping or managing someone in the NM queue, or a regular contributor, you may add them as well.
Do not modify anything besides the direct feed entries.
Hackergotchi are the little face pictures that can appear next to your entry. They should be a transparent PNG of just your head, preferably with a drop shadow behind it. Aim for around 65x85; it's not a strict size, but please don't make them much bigger than this. Please do stick to your head, not a whole square of whatever environment the head happened to be in at the time the picture was taken. It is not hard to get one done right.
Here's a good HOWTO on how to make them:
Then on here do:
git clone email@example.com:planet-team/config.git cd config/heads # place your PNG file here, $USER.png is a good filename git add $USER.png git commit -m "add/change Your Name" cd .. vi config.ini Find your feed entry and add "face", "facewidth" and "faceheight" entries, like this: [https://url.to/your/feed] name = Your Name face = $USER.png facewidth = 65 faceheight = 85 git commit -m "add/edit/remove Your Name hackergotchi" config.ini
FAQ (some sort of)
Can I add a team blog?
Planet wants to provide a window into the community. Teams are an important part of Debian and the community, so yes, you can. Simply make sure that it is clearly visible which team member posted the entry. This is usually done by adjusting your teams blog so it shows "BLOG TITLE (by Human Name)". For good examples see the DebConf and Debian System Administrator feeds.
My blog updates take a long time to appear on Planet
If you find that Planet takes hours before it notices a new blog post from you, check your webserver settings. It might happen that your webserver provides Expire headers that are something like "access + 24 hours" (or more). You want to change that to a much smaller number for the filetype of your feed.
Planet Debian runs the Planet Venus software and is currently maintained by Benjamin Mako Hill, Joerg Jaspert, and Jordi Mallach.
If you reproduce a bug with the software itself, you can file issues against the planet-venus package itself, but make sure to reproduce the issue locally with the instructions provided below.
The feeds are parsed and generated on planet-master.debian.org. As a Debian member, you have access to the server, where you can look at logs to diagnose issues, in /srv/planet.debian.org/log. You need to be quick, however: the cron jobs run every 15 minutes and only 13 logs are kept which means you have around 3 hours after publishing to look at the logs for diagnostics.
Canned response to addition requests
The following template is sent to people who email firstname.lastname@example.org about adding their RSS Feed to Planet:
Any Debian contributor is welcome to be added to Planet Debian. If you're a Debian member, you can simply add your own blog to the config file which is kept in a Git repository on Salsa. The easiest thing to do is read the instructions here: https://wiki.debian.org/PlanetDebian If you're not a Debian member, you'll need to have one of us add you. In terms of content, there are two rules. The first rule is to provide an English language only feed. The second rule is the rather vague guideline of "don't annoy people." There is absolutely no requirement that posts need to be about Debian. However, if there are a subset of posts that you are annoying a large number of people, one of us will ask you you to consider providing a feed without the posts in question. This has only happened a few times in the past. If you stay away from advertising content (or content that might be confused as such) and from excessively personal information, you should be fine. I'll be happy to welcome you to planet! Please let us at email@example.com know if you have any questions.
Venus, the software running PlanetDebian, has been unmaintained since 2011. There's been some noises about reviving it in 2016, but it seems those efforts fell through. The package was removed from Debian in Sept 2019 because it was RC-buggy, unmaintained and not ported to Python 3.
Those are the known alternatives:
Planet, Python, last commit 2006, the original implementation, abandoned
Venus, Python, last commit 2011, abandoned, used by many, many Planet sites including PlanetDebian and derivatives, Planet Haskell, Planet FSFE, Planet F-Droid, Planet Mozilla, Planet GNU, Planet Freedesktop...
moonmoon, PHP, last commit nov 2018
pluto, Ruby, last commit march 26th 2020
pluto, golang, last commit 2014
Dagobah, golang, last commit 2015, unused? abandoned?
Planet via Mailing list
People willing to receive DebianPlanet by mail can subscribe the mailing list.
send a mail containing simply subscribe ticker-planetdebian to firstname.lastname@example.org
(for more information, read the announcement on https://lists.debian.org/debian-devel-announce/2008/04/msg00013.html )
Planet in other Languages
Planet is now available in various Languages. Follow the Links below "Planetarium" on https://planet.debian.org/ to find them.
If you want to have another language set up, follow the instructions behind https://blog.ganneff.de/blog/2008/12/21/planet-i18n.html
Planet of Debian users
The traditional planets have no restrictions on topic but they are limited to Debian contributors. The planet of Debian users have a different purpose, they are open to all Debian users who blog about their favorite distribution.
To be added to a "user planet", the submitted RSS feed must contain only articles which are related to Debian (such as Debian usage stories, HOWTO taking Debian as reference distribution, opinions on Debian, etc.) and you must find a Debian contributor who will add your feed in the planet. Some "user planets" have dedicated administrators that you can contact.
There's no "right" to be syndicated on such a planet, so please be civil, respectful, otherwise your feed might get removed from the planet.