Create a HTML style guide for Drupal.org webmasters

Moving to the Redesign project. Check to see who has been assigned to implement this section and the staging server it'll live on during implementation here: http://groups.drupal.org/node/37064

Mark Boulton has also created a visual language guide, with sections on typography and grid. There are also downloadable templates. That said, it might be good for the theme maintainers to expand on this, because I don't see anything about when to use an H2 tags.

https://infrastructure.drupal.org/drupal.org-style-guide/brand.html

was talking with drumm about this on IRC - mental note, http://drupal.org/tour-redesigned-drupal-org and http://drupal.org/node/895232 are good ones to follow for markup for div usage.

seeming like this would be a good thing to tackle at some point... sooner than later (reopening and moving to docs queue)

re #5 clearing - I did ask about this #947972: proper way to clear both

It also plays into this... #947638: Convert MBD Visual Language style guide to docs nodes on d.o.

Can the Docs style guide be part of the overall d.o. style guide? (q for docs team!)

heads up on this as well: #936382: Align Handbook Styleguide with UI Best practices

my problem here (which came out when talking to you and drumm about this a bit before) is that there are things that the MBD guide that are deviations from the very long standing docs styleguide (for instance the sentence case that has been used all over for docs/handbook, and holy crap do we need to update every heading and title now???)

so my question then is - what do we do where the MBD guide diverges from the docs standards? it's going to be an enormous task to try and change all of the handbook pages to conform.

that said, i would love for the styleguide (and the UI best practices as much as possible) to *all* be consistent. i love me some uniformity of formatting, yo.

re: #10 - i believe it should be a subpage of http://drupal.org/node/700542 (not of the Handbook style guide page).

Found this issue in the Webmaster's Queue #317657: Standardized CSS for handbook pages

I know that many folks have seen this issue already but linking it here for completeness: #953560: Usage of title case on drupal.org, as specified in the Redesign Style guide
(summary: keep sentence case except in pre-designated places; this will be clarified in the d.o. style guide)

Neil, Ariane, this will be one of things to discuss at the Docs sprint I'm sure (less than a month away, yay!)

Ah, cool thanks for that note Lisa. Also yes, wooooo!!!

tags

I asked in IRC today what CSS class I should use if I wanted to display a block with text about recent updates to Project Git Instructions. drumm asked me to post what I finally chose, which was the meta class. This info about update status seemed parallel to the docs information about Needs updating, Deprecated, etc.

Since it won't always be visible, here's a screen cap of it: http://awesomescreenshot.com/0539nnr2e

The standards, guidelines, and policies for documentation are now being maintained by the Documentation Working Group (DocWG).