Problem/Motivation

It can be challenging to create a validating RSS feed, but the https://www.drupal.org/project/views_rss is a great module for this, and we could link to it on the Planet Drupal Content guideline page, by adding a short sentence to the first list item (added sentence emphasised):

1. You must have an RSS feed that contains only content appropriate for Planet Drupal. If you use Drupal, you can build a custom RSS feed with Advanced Views RSS Feed.

Steps to reproduce

Proposed resolution

Remaining tasks

User interface changes

API changes

Data model changes

Comments

ressa created an issue. See original summary.

ressa’s picture

ressa
he/him
commented
Project: Drupal.org customizations » Drupal.org content
Version: 7.x-3.x-dev »
Component: Miscellaneous » Planet Drupal
avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented

The only reference to how a Planet Feed can be produced, in the Planet Drupal content guidelines, is Important issue for blogs hosted on Github, which can be removed, since:

  • It is about an issue happened time ago (more than ten years ago)
  • The linked issue, #2164219: Meta: Feeds "looking" broken due to -1002 missing schema, is described from the Planet Drupal guidelines themselves as This most likely won't help.
  • The Planet Drupal guidelines do not put restrictions on how the content of a Planet Drupal feed is produced, but rather on its content

For the last point, I would rather not add suggestions on how a Planet Drupal feed can be produced. That can go in a different documentation guide, if it can provide enough details to be useful to somebody who wants to add their feed on Planet Drupal.

ressa’s picture

ressa
he/him
commented
Issue summary: View changes

There's an Advanced Views RSS Feed documentation page, which could be linked to? The Github chapter could be replaced with this:

Creating a RSS feed

You can build a custom RSS feed with Advanced Views RSS Feed.

avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented
Status: Active » Closed (won't fix)

I am going to close this issue, since that is a solution that works only for Drupal sites.

Hosting a feed on a Drupal site is not a requirement for Planet Drupal; a feed can also be hosted on a site running on WordPress, be generated from static pages, or even be hosted on GitHub pages.
Moderators for Planet Drupal cannot help on how to fix every issue everybody could have when trying to add a feed to Planet Drupal. I would rather not add information that is not helpful for everybody and that would need to be updated.

ressa’s picture

ressa
he/him
commented

There are already Drupal-centered tips, so your basis for rejecting my constructive suggestion for improvement seems flawed.

Request to add a feed

You must have an RSS feed that contains only content appropriate for Planet Drupal. If your site uses Drupal, you can create a Drupal Planet taxonomy term and use it to tag any content you want to show on Planet Drupal. Drupal automatically creates an RSS feed for each taxonomy term, and you can submit that term’s feed URL in your Planet Drupal application. If you are not using Drupal, you will need to make sure your site can create a feed just for your Planet Drupal content. [my emphasis]

Request to update a feed

1. You must have an RSS feed that contains only content appropriate for Planet Drupal. If your site uses Drupal, you can create a Drupal Planet taxonomy term and use it to tag any content you want to show on Planet Drupal. Drupal automatically creates an RSS feed for each taxonomy term, and you can submit that term’s feed URL in your Planet Drupal application. Alternatively, you can use the Drupal Planet module, which uses the Flag and the Views modules to create the feed. If you are not using Drupal, you will need to make sure your site can create a feed just for your Planet Drupal content. [my emphasis]

avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented

That is a left-over from the time where tagging pages with a specific tag was a requirement. Those sentences need to be removed; they are not the justification for adding more information that is not helpful for everybody who wants to create a feed for Planet Drupal.

Anyway, those sentences are not about how to build a feed, nor do they suggest a module to use. They cannot be compared to suggestions to install a specific module which could eventually become obsolete or no longer supported.

avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented
Title: Link to Advanced Views RSS Feed on Planet Drupal doc page » Link to Advanced Views RSS Feed on Planet Drupal requirements page
ressa’s picture

ressa
he/him
commented

All right. Either way, this is your domain, so you call the shots.

avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented

If there would be enough content for a documentation page, I would be fine with creating it, but that text should not be in the Planet Drupal requirements. It needs to be in a different documentation page, and probably in a different documentation guide (since the Planet Drupal requirements are a documentation page and cannot have sub-pages).

ressa’s picture

ressa
he/him
commented
Title: Link to Advanced Views RSS Feed on Planet Drupal requirements page » Link to Advanced Views RSS Feed on Planet Drupal Content guideline page
Issue summary: View changes

That sounds good, though I think adding a single sentence with a link could work better, since there is already a documentation page we can link to. Advanced Views RSS Feed seems like a tried and tested solution, and a good match for this use case, with ~3,800 modern Drupal installations.

We could add a short sentence to the first list item? (added sentence italicized)

1. You must have an RSS feed that contains only content appropriate for Planet Drupal. If you use Drupal, you can build a custom RSS feed with Advanced Views RSS Feed.

Since the sentence starts with "If you use Drupal" it's not a requirement, but a friendly tip.

Alternatively, the tip could be inserted in the intro text, right before the "Content that is great for Planet Drupal" header?