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

Comments

emmajane’s picture

emmajane commented
StatusFileSize
new css_docs-1413614-1.patch5.54 KB

Attaching the suggested updates for CSS comments and README file.

himerus’s picture

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 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 commented
Status: Needs review » Patch (to be ported)
himerus’s picture

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) commented
Issue summary: View changes

removing stub message