|
| 1 | +name: Submit a source to Planet FAIR |
| 2 | +description: Request to add a WordPress-related RSS/Atom feed to Planet FAIR (planet.fair.pm) |
| 3 | +title: "[Source]: <your-domain>" |
| 4 | +labels: ["planet", "source:proposal", "needs-review"] |
| 5 | +body: |
| 6 | + - type: markdown |
| 7 | + attributes: |
| 8 | + value: | |
| 9 | + Thanks for sharing your feed with Planet FAIR! Before submitting: |
| 10 | + • Your feed must be WordPress-focused and align with the Planet FAIR guidelines. |
| 11 | + • It must include at least one post from the last 3 months. |
| 12 | + • It should validate successfully in a feed validator. |
| 13 | + • Prefer excerpts of ~600–1000 characters. |
| 14 | + • Currently, Planet FAIR includes English sources only. |
| 15 | + See guidelines: https://github.com/fairpm/planet/blob/main/guidelines.md |
| 16 | +
|
| 17 | + - type: dropdown |
| 18 | + id: request_type |
| 19 | + attributes: |
| 20 | + label: Request type |
| 21 | + description: Choose whether you’re adding a new feed or updating an existing one. |
| 22 | + options: |
| 23 | + - Add a new feed |
| 24 | + - Update an existing feed |
| 25 | + default: 0 |
| 26 | + validations: |
| 27 | + required: true |
| 28 | + |
| 29 | + - type: input |
| 30 | + id: display_name |
| 31 | + attributes: |
| 32 | + label: Preferred display name |
| 33 | + description: How the source should be shown in Planet FAIR (e.g., “Example Dev Blog”). |
| 34 | + placeholder: Example Dev Blog |
| 35 | + validations: |
| 36 | + required: true |
| 37 | + |
| 38 | + - type: input |
| 39 | + id: site_url |
| 40 | + attributes: |
| 41 | + label: Site URL |
| 42 | + description: The home page of your site. |
| 43 | + placeholder: https://example.com/ |
| 44 | + validations: |
| 45 | + required: true |
| 46 | + |
| 47 | + - type: input |
| 48 | + id: feed_url |
| 49 | + attributes: |
| 50 | + label: Feed URL (RSS or Atom) |
| 51 | + description: Provide a category/tag feed if your site mixes topics so only Planet-appropriate posts appear. |
| 52 | + placeholder: https://example.com/category/wordpress/feed/ |
| 53 | + validations: |
| 54 | + required: true |
| 55 | + |
| 56 | + - type: dropdown |
| 57 | + id: feed_format |
| 58 | + attributes: |
| 59 | + label: Feed format |
| 60 | + description: Planet FAIR supports RSS or Atom. |
| 61 | + options: |
| 62 | + - RSS |
| 63 | + - Atom |
| 64 | + validations: |
| 65 | + required: true |
| 66 | + |
| 67 | + - type: input |
| 68 | + id: recent_post |
| 69 | + attributes: |
| 70 | + label: Link to a recent post (≤ 3 months old) |
| 71 | + description: Used to verify recency. |
| 72 | + placeholder: https://example.com/2025/08/awesome-wp-post/ |
| 73 | + validations: |
| 74 | + required: true |
| 75 | + |
| 76 | + - type: input |
| 77 | + id: validator_link |
| 78 | + attributes: |
| 79 | + label: Feed validator result URL |
| 80 | + description: Paste the result URL from a validator (e.g., W3C). Submissions with errors may be paused. |
| 81 | + placeholder: https://validator.w3.org/feed/check.cgi?url=https%3A%2F%2Fexample.com%2Ffeed%2F |
| 82 | + validations: |
| 83 | + required: true |
| 84 | + |
| 85 | + - type: checkboxes |
| 86 | + id: compliance |
| 87 | + attributes: |
| 88 | + label: Guidelines & eligibility |
| 89 | + description: Confirm your feed aligns with Planet FAIR criteria. |
| 90 | + options: |
| 91 | + - label: My feed includes only WordPress-appropriate content per Planet FAIR guidelines. |
| 92 | + required: true |
| 93 | + - label: My feed has at least one post in the last 3 months. |
| 94 | + required: true |
| 95 | + - label: My feed validates without errors/warnings that affect parsing. |
| 96 | + required: true |
| 97 | + - label: My feed provides excerpts around 600–1000 characters (or a summary field). |
| 98 | + required: true |
| 99 | + - label: My feed is primarily in English. |
| 100 | + required: true |
| 101 | + - label: I understand feeds may be removed for guideline violations, inactivity, spam, or non-WP content. |
| 102 | + required: true |
| 103 | + |
| 104 | + - type: checkboxes |
| 105 | + id: content_types |
| 106 | + attributes: |
| 107 | + label: Primary content types |
| 108 | + description: Helps moderators categorize your source. |
| 109 | + options: |
| 110 | + - label: Development |
| 111 | + - label: Themes |
| 112 | + - label: Plugins |
| 113 | + - label: Advocacy / Community |
| 114 | + - label: Events / Meetups |
| 115 | + - label: Case Studies |
| 116 | + - label: FAIR project updates |
| 117 | + - label: Other |
| 118 | + |
| 119 | + - type: textarea |
| 120 | + id: scope_notes |
| 121 | + attributes: |
| 122 | + label: Scope notes (optional) |
| 123 | + description: If needed, note which categories/tags your feed includes (e.g., only posts tagged “WordPress”). |
| 124 | + placeholder: "Example: Only posts under /category/wordpress/ are in this feed." |
| 125 | + |
| 126 | + - type: input |
| 127 | + id: update_original_issue |
| 128 | + attributes: |
| 129 | + label: Link to original addition request (if updating) |
| 130 | + description: Provide the previous issue URL if this is an update request. |
| 131 | + placeholder: https://github.com/fairpm/planet/issues/123 |
| 132 | + |
| 133 | + - type: input |
| 134 | + id: contact_name |
| 135 | + attributes: |
| 136 | + label: Contact name (optional) |
| 137 | + placeholder: Jane Doe |
| 138 | + |
| 139 | + - type: input |
| 140 | + id: contact_email |
| 141 | + attributes: |
| 142 | + label: Contact email (optional) |
| 143 | + placeholder: email@example.com |
| 144 | + |
| 145 | + - type: input |
| 146 | + id: social |
| 147 | + attributes: |
| 148 | + label: Social (optional) |
| 149 | + description: Mastodon/Twitter handle for attribution if needed. |
| 150 | + placeholder: "@example" |
| 151 | + |
| 152 | + - type: markdown |
| 153 | + attributes: |
| 154 | + value: | |
| 155 | + Moderation note: By submitting, you accept that Planet FAIR moderators may approve, defer, or remove feeds based on the guidelines and community safety policies. |
0 commit comments