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

jensimmons commented

subscribe

tlattimore’s picture

tlattimore commented

sub

arianek’s picture

arianek commented
Issue tags: +theming

tags

arianek’s picture

arianek commented
Priority: Normal » Major
sylvain_a’s picture

sylvain_a commented
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

Carolyn commented
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

arianek commented

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

Carolyn commented

http://drupal.org/node/1099422 - core themes

http://drupal.org/node/1099438 - bartik
http://drupal.org/node/1099450 - seven
http://drupal.org/node/1099464 - stark
http://drupal.org/node/1099466 - garland

arianek’s picture

arianek commented

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

Carolyn commented

Thanks!

perze’s picture

perze commented
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

perze commented
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

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

assigning correct closing status