Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
New section got added to Drupal.org style guide - Content guidelines. It's purpose is to gather guidelines for content creation and promotion for various content types.
Currently guide for case studies is in work.
What needs to be done:
- Add guidelines for:
- front page posts
- marketplace nodes
- book pages (in future)
- ?
Original post by silverwing
Lately we've been getting more site announcements than actual success stories in http://drupal.org/success-stories so we should probably come up with some guidelines on what's appropriate, what's not, etc.
Comments
Comment #1
Alex UA CreditAttribution: Alex UA commentedI also wonder whether we should be encouraging people to post issues there (as the text on the main page currently does), or whether this section should be more curated (I believe it needs to be). This is also related to the redesign for this section, so I'm tagging as such.
Comment #2
apadernoComment #3
lisarex CreditAttribution: lisarex commentedYes, definitely, we need guidelines. I'm envisioning a drupal.org content guide that guides and encourages the creation and *maintenance* of good content :)
See #1154526: Create a single Drupal.org style guide
subscribe
Comment #4
lisarex CreditAttribution: lisarex commentedThe style guide now lives at http://drupal.org/style-guide but is very generic. We want to encourage quality content in other areas....
How about a single page that breaks out additional guidelines for the various types of content...
1. Case studies
2. Front page posts (currently exists in http://drupal.org/front-page-schedule )
3. Marketplace nodes
and anything else.
Comment #5
tvn CreditAttribution: tvn commentedGuidelines for content types are indeed necessary, only I am not sure if single page is best option since they will also include various "how x can get promoted to y" and might get too long. Maybe a collection of pages, 1 per content type.
What do you think would be the best place for such guidelines? I'd say http://drupal.org/about-drupal.org
Since it's not really related to style and not for site maintainers.
Comment #6
jhodgdonI think it should be under the http://drupal.org/style-guide, since that section has all kinds of other guidelines. We should probably re-title the page/section though... maybe "Drupal.org style and content guidelines"?
How about if we start a new page under that entitled "Content guidelines"? We can move the pages about images/screenshots and about the documentation structure and documentation comments under that page, and add other pages about case studies, front page posts, etc.
Comment #7
tvn CreditAttribution: tvn commentedjhodgdon, I agree with all your suggestions, going to create page for content guidelines.
Now only question, maybe slightly off-topic, why we have "Drupal.org style and content guidelines" and "Drupal.org site maintainers guide" under "Getting involved" and not "About Drupal.org"? I think it makes more sense to have everything related to Drupal.org at one place. Getting involved guide is already huge, and About Drupal.org will have even less content when guidelines for marketplace and book page will be moved to content guidelines.
What do you think about moving those 2 to "About Drupal.org"?
Comment #8
jhodgdonWell, all (or at least most?) of our other instructions about how to get involved as a Drupal project contributor (documentation, code, themes, etc.) are under Getting Involved. So to me, it makes sense that the style guidelines should be there too.
I don't see why it's a problem if the "About Drupal.org" book is small. It could be just one page for all I care. We shouldn't have to explain much about Drupal.org...
Comment #9
tvn CreditAttribution: tvn commentedYeah, length of the book is not a problem. I'd just love to see "full guide about drupal.org" at one place, including something like:
- Some general information
- Here are modules which run the site
- Here is style guide and how we theme things
- Here are content types we have and how to promote them to various places
- Here is some infrastructure information
- Here are people who maintain the site
etc.
Comment #10
jhodgdonI see what you are saying, but at present, we cannot put the same page in two books. Also, we don't want to duplicate information. So, links are your friend. :)
Let's leave the style guide where it is, and you can link to it from the About section.
Comment #11
tvn CreditAttribution: tvn commentedI renamed style guide to "Drupal.org style and content guidelines", created Content guidelines page, moved there 3 pages mentioned in #6 and added Case studies guidelines page. What we also can do now is probably add guidelines for Front page posts there.
Also updated issue summary.
Comment #12
jhodgdonLooks good! I just edited the landing page http://drupal.org/style-guide to reflect the new reality.
So... Looking at the issue summary (thanks for updating it tvn!), it looks like we also want to move into here and/or write:
- Marketplace guidelines
- Front page post guidelines
(the book page guidelines will come later, when we deploy the new book content type)
Comment #13
lisarex CreditAttribution: lisarex commentedtvn and I were just discussing this, and it does make sense to move all the content & style guides to About drupal.org. As someone looking for guidelines, I doubt they'd find them right away in Getting Involved
At one point in time, I moved them to the Getting Involved section, but now that there's a lot more going in with this section, I think it belongs elsewhere.
Comment #14
DSquaredB CreditAttribution: DSquaredB commentedWith the updates to the Marketplace and Case Studies sections and the creation of the Content queue, it makes sense to have the all the Guidelines for those areas grouped together. But, the Getting Involved section should contain information about helping with content reviews and links to the reviewing guidelines.
Comment #15
tvn CreditAttribution: tvn commentedDSquaredB, I agree that if content guidelines are in the About Drupal.org, Getting involved needs information on how to help with review/moderation. Already started working on these docs: http://drupal.org/node/1624450
Comment #16
tvn CreditAttribution: tvn commentedOver the past couple of weeks, guidelines for various content types were gathered in http://drupal.org/about-drupalorg, along with the D.o style guide and various content-related pages under Content overview section. We probably can mark this issue fixed.
Comment #17.0
(not verified) CreditAttribution: commentedupdating issue summary