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

Alex UA’s picture

I 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.

apaderno’s picture

Component: Case studies » Other
lisarex’s picture

Yes, 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

lisarex’s picture

Title: Create guidelines for /success-stories nodes » Create guidelines for content by type

The 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.

tvn’s picture

Guidelines 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.

jhodgdon’s picture

I 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.

tvn’s picture

jhodgdon, 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"?

jhodgdon’s picture

Well, 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...

tvn’s picture

Yeah, 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.

jhodgdon’s picture

I 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.

tvn’s picture

I 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.

jhodgdon’s picture

Looks 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)

lisarex’s picture

Title: Create guidelines for content by type » Organize guidelines for content by type; move them to About drupal.org

tvn 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.

DSquaredB’s picture

With 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.

tvn’s picture

DSquaredB, 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

tvn’s picture

Status: Active » Fixed

Over 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.

Status: Fixed » Closed (fixed)
Issue tags: -drupal.org redesign, -drupal.org case studies

Automatically closed -- issue fixed for 2 weeks with no activity.

Anonymous’s picture

Issue summary: View changes

updating issue summary