10 replies to this topic

[JohnMagic]

The framework it self seems nice, even though I have not tested it live yet with plugins and the wiki is nice in explaining how stuff work out-of-the-box. The framework needs child themes though and as I understand there i absolutely no documentation for the only child theme iBlog5. As far as I have experienced theres no wiki documentation, no readme documentation, no changelog documentation, and no inline documentation in css etc. Theres also changes from iBlog4 that makes it neccessary to redo customizations done on iBlog4 to have the same look and functionlity in iBlog5. For a framework to be successful it needs good child theme, and documentation is an important part of theme quality. I strongly suggest that the Pageline developers document the child themes.

[mackenzie]

The developers have just informed me that the documentation for child themes is, in fact, being developed and should be published in the next few weeks. If you have a specific question though, please feel free to let us know and we'll be happy to help.

[JohnMagic]

What will the documentation include ?

[catrina]

I'm not certain what exactly the documentation will include.

[JohnMagic]

Is there anything the documentation is known to include, and would you/the devs like to have community input on what do document and how to document ?

[Simon_P]

What sort of documentation do you need? How to install a child theme? Here are the docs on how to use the blank base theme to customize your parent theme: http://www.pagelines..._the_Base_Theme Problem here is you have already installed a child theme, and wordpress will only allow one child to be the active theme, grandchild themes are not supported and never will be. So we invented the customize plugin, which emulates a child theme. http://www.pagelines...ustomize_Plugin

[JohnMagic]

It would be useful if you documented div and css structure and naming schemes. Theres a dusin or more css files in framework + child theme.

[catrina]

By DIV and CSS structure are you referring to a list of the CSS selectors?

[JohnMagic]

Div structure may be done as a graphic with comments, I have seen it done with on other frameworks. Css need to be more than a list, it should document how the css for the most important elements work.

[catrina]

I have seen it done with other frameworks, as well. Thanks for the suggestion.

[Simon_P]

Did you check out this? http://www.pagelines...electors#Item_1 Few other useful links http://www.pagelines...izations#Item_1