The theme is currently not "self-documenting". It lacks the basic information new themers need to efficiently create a sub-theme. This is based on my experience working with 200+ novice themers and the Omega base theme. Attached is a patch which adds comments to the files in the CSS folder of the alpha-xhtml starter kit.

CommentFileSizeAuthor
#1 css_docs-1413614-1.patch5.54 KBemmajane
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

emmajane’s picture

emmajane CreditAttribution: emmajane commented
FileSize
css_docs-1413614-1.patch5.54 KB

Attaching the suggested updates for CSS comments and README file.

himerus’s picture

himerus CreditAttribution: himerus commented
Assigned: Unassigned » himerus

Emmajane,

Thank you for this! It has definitely been needed for some time since the 3.0 work began.

I'm planning on (very shortly) starting a push to the next release (3.1) with some outstanding bug fixes, and I'll look this over, and make sure it is included.

himerus’s picture

himerus CreditAttribution: himerus commented
Status: Active » Needs review

This has been added to the Omega 3.1 Roadmap for inclusion in the next official release.

Cellar Door’s picture

Cellar Door CreditAttribution: Cellar Door commented
Status: Needs review » Patch (to be ported)
himerus’s picture

himerus CreditAttribution: himerus commented
Assigned: himerus » Unassigned
Status: Patch (to be ported) » Fixed

I've applied this patch, and also duplicated the efforts in the starterkits for omega html5 and omega xhtml so that they are properly reflected in ANY starterkit someone picks up.

Also added a line into global.css that lets a user know that it really IS global...

Emmajane, thank you for this patch! it has been committed, and will be in the 3.1 release.

Status: Fixed » Closed (fixed)

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

Anonymous’s picture

(not verified) CreditAttribution: commented
Issue summary: View changes

removing stub message