The Drupal Association's Drupal.org Content Working Group has been working on an updated version of the Drupal Planet Guidelines to clarify a number of outstanding questions. The intent of the update is to better explain the purpose of Planet Drupal in contrast to other Drupal.org resources, and clarify some of the more subjective criteria for inclusion on the Planet.
We've taken the previous discussions at #928092: Update and clarify Planet Drupal guidelines and #1035184: Form a community consensus on Planet Drupal guidelines into consideration while working on the update, and believe it reflects the concerns of the participants in those discussions as well as explaining the principles behind the few rules that do exist. The updated version of the Guidelines is below, and comments are welcome! Barring any major outrage, we hope to make these update guidelines "official" sometime during DrupalCon Prague.
---
What is Planet Drupal?
Planet Drupal is an aggregated list of feeds about Drupal from around the web. It provides a place for interesting content from around the community that may not fit the existing topical sections of Drupal.org, Groups.drupal.org, and other official forums. Its purpose is the sharing of useful and relevant Drupal-related knowledge; posts that are aggregated on the planet should help others learn details about Drupal that they might not otherwise encounter.
Content that's great for Planet Drupal :
- How-tos, guides, and tutorials that highlight how to use Drupal effectively.
- Module, theme, profile, and distribution announcements, preferably with some discussion or background.
- Case studies that highlight how Drupal was used on a project.
- Slides and presentations from Drupal-related talks, or notes from a past presentation.
- Community news, like progress updates on an in-progress Drupal initiative or project.
- Posts should be in English since that's the language used on Drupal.org.
- Like all interactions with the Drupal community, posts to the Planet should follow the Drupal Code of Conduct.
Content that doesn't fit Planet Drupal:
- Press releases. These can be posted into the News and Announcements forum.
- Job announcements and hiring announcements. It's fine to mention a career change in the context of another post, but remember that Drupal Planet isn't LinkedIn. Job postings can be posted into the Jobs page.
- General web development and programming posts that only mention Drupal in passing.
- "I Love Drupal!" posts that don’t provide valuable, actionable content to readers.
Other places for special Drupal-related content
- Announcements about Drupal-related events can be posted on the groups.drupal.org events page.
- Job openings and resumes can be posted on the groups.drupal.org jobs page.
- Case studies explaining how a particular Drupal site was built can be submitted in the Drupal.org Case Studies section.
How to get your feed to the Planet:
If you have content fitting the requirements above, then here are the next steps.
- You must have an RSS feed that contains only content appropriate for Drupal Planet. If your site uses Drupal, you can create a "Drupal Planet" taxonomy term and use it to tag any content you want to appear on the Planet. Drupal automatically creates an RSS feed for each taxonomy term, and you can submit that term’s feed URL in your Drupal Planet application. If you are not using Drupal, you will need to make sure your site can create a feed just for your Planet content.
- Your feed must have at least two posts already so we can evaluate the content and make sure it is appropriate for the Planet.
- Your feed must pass source code validation, since Drupal's aggregator module is very strict about parsing feed source code.
- It is recommended that you trim, or use a summary for your feed content between 600 and 1000 characters. Due to the number of posts on the Planet, this will make it more pleasant for readers to find what is interesting for them without having to scroll page after page.
- It is recommended that you enable reader comments for content that appears on Drupal Planet. Because Planet content is intended to increase communication and connection in the Drupal community, dialogue and feedback are important.
- Once your feed meets the above requirements, create an issue in the Drupal.org Content project asking to be added to the Planet. Remember to include the link to your feed, as well as the name you would like in the listing (e.g. Jane Doe or My Company Name).
A feed may be removed from the Planet if:
- it does not meet the content guidelines stated above
- it violates the Drupal Trademark and Logo Policy
- it contains spam, is hacked or posts are offensive
- it no longer works or no longer Drupal specific
- it hasn't been updated in a year
If you find a post on Planet Drupal that you feel is inappropriate or in violation of the content requirements above, create an issue for it in the Drupal.org Content project. Please do not leave comments on the article itself telling the author that his/her post is not welcome on Planet Drupal: the Drupal Planet moderators will look into the issue and determine whether the violation merits a warning or removal from the Planet feed.
Feed owners who disagree with a decision can appeal by creating a followup issue in the Drupal.org Content project. The appeal will be discussed and voted on by the Drupal Planet content moderators, but their decision will be final.
Comments
Comment #1
dave reidI think this looks great!
Comment #1.0
dave reidFixed missing space
Comment #2
sunEdited a typo/grammar error.
IMHO, this should be a MUST, not a MAY.
The https://drupal.org/planet page itself (and most probably some similarly poor feed readers) are exposing the full, untrimmed content ohterwise - hurting readability and discovery.
Every single time I visit that page (including right now), it contains some full-length posts. Site owners who properly trimmed their summaries inherently appear to be less relevant, due to the full-length posts that are dominating the page. That is wrong.
Comment #3
eaton commentedThanks for catching that -- I'll update it. And after consideration, I agree on the MUST/MAY switch for trimming.
Previously, open commenting was a MUST and I've lobbied to turn it into a 'MAY', based on the idea that a community news stream doesn't necessarily have to include discussion provisions on each article. For some sites, turning off comments and engaging in other ways (social media, drupal.org forums, counter-posts on other blogs, etc) are a better choice. It's something to encourage but not necessarily require.
At least, that's my feeling -- I'm curious if others in the community feel the same way!
Comment #4
tvn commentedtag
Comment #5
dddave commentedThanks for the effort on this.
Regarding trimming/summary: There is this long standing issue slightly favoring trimming (if I remember correctly) #299884: Implement Aggregator Item Length module on Drupal.org
Anyways: I +1 trimming.
Regarding the need for comments: #1940276: Drupal Planet Guidelines regarding comments
I can live with a MAY but personally would prefer a MUST. We want to prevent even more marketing and fluff and I think the ability to discuss a post is very important (or to post corrections). But this isn't a deal-breaker here.
In any case I would prefer that we point out our encouragement to enable anonymous comments or use a easily accessible system like disqus (i.e. no requirement to log into a site specifically).
A highly problematic point imho is this:
Maybe we need only some advise to webmaster (as this proposed document is outward facing) how to handle this but in the past this point has been a bitch to manage. It seems to be general webmaster policy NOT to police trademark issues as most of us are not qualified enough to do so AND we are not the instance to enforce the trademark as we are not the trademark holders.
I have studied law for a couple of years (in Germany but also with focus on international law) so I can handle legal mumbo-jumbo but even I have to say that the specifics of this licence/trademark stuff can be VERY itchy.
I propose we (at least internally) make it clear that this is not up to webmaster review (for the most part because we are not qualified to). Instead we remove a feed IF the trademark holder notifies us about a misuse. This would shift the conflict to the instance which holds the trademark (and they can contact the offender directly). As said before: I don't think we as webmaster can handle this professionally enough.
Comment #6
gregglesUnless webmasters (or some specific person/group is delegated with authority to enforce the trademark) I am agreed with #5 re trademark: let the trademark owner/deciders contact us if their is a violation, not the other way around.
I suggest removing the part about trimming. It's a very contentious issue given that the feed is used in multiple ways by multiple people. It can only be solved in a way that pleases everyone if it's full feed to start and trimmed client side.
The g.d.o jobs feed is not for resumes, so that should be removed. The g.d.o/jobs page is also mentioned twice - probably once is enough :)
Comment #7
eaton commentedI tend to agree on the trademark issue; the Association does not own the Trademark, and my understanding is that there is no system in place that would allow us to act as enforcers of the trademark. (There's an ongoing discussion over on this thread about precisely that issue. I'll run it past the rest of the working group and see what we can iron out.
Thanks, too, for the feedback on comments. I think there are a lot of pros and cons to it: my biggest concern is that a lot of high-value sites I read on a daily basis, ones that would probably be useful in Planet, rely on other channels (like social media) for responses and feedback. Forcing independent participants like that to rework their sites feels counter-productive, but I definitely think that the "Press Release Firehose" is easier to keep at bay if commenting is required. I was the lone wolf who was arguing that it should be optional, so it probably makes sense to add it back.
How about: MUST have comments, and we RECOMMEND that comments be open for anonymous users, or that an "open" commenting system be used so that users don't have to create an account on the site itself?
Comment #8
Crell commentedAgreed with #5 on trademark issues.
For comments, perhaps generalize it to "some form of reader feedback" as a way to discourage press releases? That still leaves it open to Drupal comments, Wordpress comments, Disqus, a "Tweet us" button, whatever.
On trimming, I don't know how many people read Planet via the web site vis RSS. I read via RSS and virtually never see the site, so untrimmed articles are actually better for me. For people viewing on the site, though, I agree that shorter is better.
Is there no way we can do the trimming on our end for HTML display, but let through whatever people post for RSS purposes? That seems like a completely reasonable content strategy thing to do... :-)
Comment #9
dave reidAgreed on trademark.
I also think we should encourage people to use full posts but it is not required. It's actually *very* easy for us to fix on Drupal.org either using a *new module* (https://drupal.org/project/aggregator_item_length) or a simple template_preprocess() hook in the drupalorg.module. I encourage full posts in RSS because Drupal.org itself re-publishes its RSS feeds using the full text and not teasers. So people on Planet would get more value if they provided the full post, to those that read the Planet via RSS.
Comment #10
laura s commentedRe 1., the taxonomy prescription seems extraneous. There are many ways to make a Planet-only feed. (E.g., using flag.)
Re 4., for me, trimming gets in the way. It forces me to click through. It's easy enough to scroll through something I'm not interested in. Teasers otoh don't tell me if the post is even going to get to the points I'm interested in. If the goal is to drive traffic to sites, great. If the goal is to disseminate knowledge, untrimmed is better imho.
Re 5., I think it's fair to require comments. I do not believe that it is reasonable to require or suggest that people allow anonymous comments.
Also, the guidelines seem to be in conflict regarding case studies:
In the past, case studies have been frowned upon in the Planet, unless it was focused on a particular module or issue. Portfolio items in general have been discouraged. I'm not sure I have a strong opinion either way about this, but I wanted to note the ambiguity and history here.
The rest looks great imho!
Comment #11
pasquallethis sentence is not clear legally.. Content guidelines are scattered in 3 sections..
warning vs removal
I know it is a case by case decision, but still there is no rule in the document when the site will be removed for sure.
- I think we can say the feed will be removed without discussion if it "contains spam, is hacked or posts are offensive".
- repeated warnings should be also automatic removal. This should be written in the guidelines as nobody will get removal just for posting a job announcement, and we need to make sure he will not continue doing so.
I don't really understand why to create a new issue, as the issues are public and the blog author might already commented in the original complaint.
I would simply remove this part, as this part can't be really enforced. I believe a 1 year ban from planet should be the maximum penalty for any site which posted at least 2 appropriate posts about Drupal (which is a must for getting to planet). I don't agree with final decision here.
Comment #12
eaton commentedThis might be a problem with language -- in English, when a decision is "final" it doesn't imply that someone will never get another chance in the future. It just means that a decision to remove a blog from Planet can't be endlessly "appealed" once the team has made the decision. I'll see if we can clarify it a bit to make it more obvious.
Would it help if these guidelines were stated in IMMEDIATE REMOVAL and WARNING form, similar to the MUST and RECOMMENDED guidelines used below? Spam, harassment, etc would obviously mean immediate removal while general guideline violations would result in warnings.
This is a reflection of the nature of an "issue" on Drupal.org: an ticket is closed when final action is taken -- either warning the blogger, or letting it pass, etc. Appealing the decision is technically opening a new request that gets treated as its own "thing" to resolve. I'll circle back around on this issue, but I'm concerned about the difficulty of keeping track of issues that get opened, closed, re-opened, and re-closed depending on different peoples' requests.
Comment #13
gregglesFrom a ticket perspective I agree with you. From a practical perspective...it's easier to get attention of interested parties if you re-open an existing ticket. How about something in-between: open a new issue but link to it from the old issue. Kind of like #928092-115: Update and clarify Planet Drupal guidelines.
Comment #14
dddave commentedre #13
If there is an issue with an existing feed it is definitely easier and much more practical to reopen the old issue where the author of the feed is subscribed to. It is quite annoying for me hunting down maintainers of feeds added many moons ago without having a original issue to get at least a profile link to contact a person. In the last months since I've been heavily involved in Planet management I found it very convenient to reopen an issue if problems came up.
Couldn't we handle these issues like those for marketplace listings? Those are also used as the one-stop-shop for all issues regarding a listing page (e.g. if a page hasn't been updated in the last twelve months the issue status is changed from closed/fixed to needs work). I personally appreciate the ease of use of this approach.
About the "final decision": Doesn't sound right to me. I am with Pasqualle on that although I understand the meaning of it. We need to clarify when a banned feed can reapply.
"Warning vs Immediate Removal" -> what eaton proposes in #12
Comment #15
gregglesThis seems like a great and reasonable process if a little incomplete. Was anyone else consulted directly? Who do you hope will manage the queue on an ongoing basis?
To cut to the end of those questions: it seems important in this process and in our ongoing governance processes to solicit feedback directly from the people currently doing work to help ensure they are willing to continue doing work (unless there is someone else who has volunteered to do the work based on this set of guidelines).
So, here is a query and the results of who is active in planet drupal queue in the last year:
So, dddave - thank you so so so so much! You are the only person more prolific than that amazingly consistent and productive System Message guy ;)
Comment #16
dddave commentedThanks. ;)
The backlog in the Planet queue was what got me involved with the webmaster team in the first place as I wanted to help out. For the foreseeable future I won't leave.
I personally think the discussion here in this issue has addressed some points which I would like seen at least taken into consideration before finishing the new guidelines (which overall seem like a good improvement).
One point that isn't well reflected so far and I don't know how practical we could bring something like this into the guidelines is "Content Quality". Since I took a dive into this stuff I had more than a handful requests that would technically qualify but that I rejected for lack of quality. For the most part these were very low level articles obviously aimed at not tech savvy customers. Another quite common issue is that the topic of an article covers an already very well covered topic (updating a drupal install for example or basic drush commands). So far bringing up my objections either resulted in simply not following-up the issue (mostly by companies that obviously wanted to get on the Planet for promo reasons) or agreeing and resubmitting new content. So from a practical standpoint we don't need to write a "quality" requirement down as nobody has made a big stink so far. Just wanted to mention this.
Comment #17
dddave commentedSo, is something happening with this?
Comment #18
eaton commentedYes -- the ball's definitely in my court at the moment, and I've been swamped in the month following Drupalcon. Thanks for the ping. ;-)
Comment #18.0
eaton commentedUpdated issue summary.
Comment #19
webchickCross-linking.
Comment #20
dddave commentedjust poking to see if it is still alive
Comment #21
eaton commentedAdded the DCOC reference to the list of expectations for Planet content.
Comment #22
eaton commentedYes, though I've been AWOL for long enough that you can be forgiven for assuming it died. ;-)
The primary outstanding issue at the moment is lack of clarity around the specific mechanism for removing items from Planet and who's responsible for those. It technically falls to the Webmaster group to do that at present, but putting more legwork on their plate isn't the intended effect.
Right now, I believe the best course is to update the Planet guidelines with the version that's been hashed out in this thread, and follow-up to work through the specifics of the webmaster workload and what the guidelines' impact on them will be.
Comment #23
dddave commentedI don't think that burden would be to heavy to carry.
We definitely need more hands on deck for other tasks, esp. sophisticated tasks like case study reviews.
Creating better anti-spam meassures or eleminating the not-a-spammer process would free up a lot though (that as a side-note).
Comment #24
eaton commentedThe guidelines at https://drupal.org/planet/guidelines have been updated. Thanks for the help and feedback, everyone!
Comment #26
soul88http://www.mediacurrent.com/blog/meet-erin-bush
Can please anyone tell me what is this post doing on the Planet? Or how can one promote his/her career switch on Drupal Planet?
P.S. Please tell me where is it appropriate to ask such questions, if this issue is the wrong place.
P.P.S. I don't know Erin in person so by default I assume she's a great person. But I think that such posts are a bit inappropriate for the Drupal Planet. I can see no value there except for Mediacurrent marketing.
Comment #27
dddave commented#2226155: Problems with content on MediaCurrent's feed.
Comment #28
avpaderno