am i nuts or is there no instructions on what docs should exist for new themes (esp core themes)? also, are there no docs at all for existing core themes? i could only find them for contrib ones: http://drupal.org/node/196218

if anyone knows pls fill me in so i can pass on the info to jensimmons who's working on bartik for D7

Comments

jensimmons’s picture

subscribe

tlattimore’s picture

sub

arianek’s picture

Issue tags: +theming

tags

arianek’s picture

Priority: Normal » Major
sylvain_a’s picture

Component: New documentation » Correction/Clarification

Hello Ariane,
If you are willing to create the section and pages, I'd be willing to contribute a draft to get this rolling. I'm assuming the original maintainers will jump in at one point if something is already in place.

Suggestion:
1) Create "Core Themes" as a children page from http://drupal.org/documentation/theme. It could be good to make it appear before "Contributed Themes"
2) Create "Bartik", "Seven" and "Stark" children pages beneath.
These pages should only contain factual information like regions, theme settings, or information that would appear in "README.txt" files.

Ironically, for Bartik, the README file was removed because people assumed it was already available on d.o. (reference)

(While we're at it, if you feel this is useful at the moment, I would consider making it an informal "Request to be a documentation admin".)

Carolyn’s picture

Status: Active » Needs review

I created a Core themes section as suggested, and pages for the four core themes in Drupal 7.

arianek’s picture

Indeed - Sylvain, do you not have access to the "add a child page" link? It's been a while since I had regular auth user perms, but I thought anyone could do that...

If you want to post the links for the new pages, I'm happy to alias them with some nice /documentation/themes/[theme-name] urls

Carolyn’s picture

arianek’s picture

Cool - I've updated URL aliases for all but garland (I wasn't sure if there are other docs buried somewhere for Garland, we should make sure not first). I also added links to the project pages at the starts of each and filed issues with each of those 3 projects to get the docs page linked to from their project pages (the individual projects are still used to maintain the D6 versions/backports of each).

Carolyn’s picture

Thanks!

perze’s picture

Issue summary: View changes

Looks like Core Theme documentation has been consistent and has come a long way since this issue was last commented on.

Is it safe to assume that we can close this issue?

perze’s picture

Status: Needs review » Reviewed & tested by the community

closing this based on existing documentation as well as age of the ticket. please see previous comment for reference.

perze’s picture

Status: Reviewed & tested by the community » Closed (outdated)

assigning correct closing status