You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by "Michael Brooks (JIRA)" <ji...@apache.org> on 2012/07/11 23:23:33 UTC
[jira] [Created] (CB-1033) Update Documentation Theme to Match
Homepage
Michael Brooks created CB-1033:
----------------------------------
Summary: Update Documentation Theme to Match Homepage
Key: CB-1033
URL: https://issues.apache.org/jira/browse/CB-1033
Project: Apache Cordova
Issue Type: Bug
Components: Docs
Affects Versions: 2.0.0
Reporter: Michael Brooks
Assignee: Michael Brooks
Fix For: 2.0.0
Update the theme to match [cordova.io|http://cordova.io]
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Commented] (CB-1033) Update Documentation Theme to Match
Homepage
Posted by "Tim Kim (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CB-1033?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13415610#comment-13415610 ]
Tim Kim commented on CB-1033:
-----------------------------
Hey Mike,
I've got the basic layout done for Geolocation on my branch: https://github.com/timkim/incubator-cordova-docs/tree/cb-1033-cordova-theme
What are we thinking for the nav bar stuff? Are we going to go with the left nav bar like the current docs are doing or are we thinking of putting things in the header and have roll down links? The first suggestion is probably easier to navigate but the second matches more closely to the cordova design.
> Update Documentation Theme to Match Homepage
> --------------------------------------------
>
> Key: CB-1033
> URL: https://issues.apache.org/jira/browse/CB-1033
> Project: Apache Cordova
> Issue Type: Bug
> Components: Docs
> Affects Versions: 2.0.0
> Reporter: Michael Brooks
> Assignee: Michael Brooks
> Fix For: 2.0.0
>
>
> Update the theme to match [cordova.io|http://cordova.io]
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Commented] (CB-1033) Update Documentation Theme to Match
Homepage
Posted by "Tim Kim (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CB-1033?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13415824#comment-13415824 ]
Tim Kim commented on CB-1033:
-----------------------------
Hrmmm,
Another thing I noticed is what happens when you shrink the website horizontally. If you go to cordova.io and start shrinking the window size horizontally, eventually the top nav bar links collapse into a drop down.
I'm thinking of having a layout where the we have the top header stay the same but have two drop downs. One for the version and the other for table of contents.
Then we have the left nav bar for links to the other pages of docs giving the rest of the space of content.
When we start shrinking the site, the left nav bar should become unfixed (not sure if that's the term) and have the content flow below it. Not sure if that 's do-able cleanly - it's been awhile since I've practiced my css-fu, but I'll give it a shot. In any case - I think that will match Cordova theme and retain the functionality of how the docs are right now. Seems to be a good middle ground.
Other than that, I'm uncertain how to layout the navbars. There are quite a few items just for the api references and guides, so having a horizontal nav bar at the top for all of those links would be a mess. Especially if we consider putting everything into a drop down.
I hope that's descriptive enough, might've been easier to just draw a picture :)
> Update Documentation Theme to Match Homepage
> --------------------------------------------
>
> Key: CB-1033
> URL: https://issues.apache.org/jira/browse/CB-1033
> Project: Apache Cordova
> Issue Type: Bug
> Components: Docs
> Affects Versions: 2.0.0
> Reporter: Michael Brooks
> Assignee: Michael Brooks
> Fix For: 2.0.0
>
>
> Update the theme to match [cordova.io|http://cordova.io]
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Commented] (CB-1033) Update Documentation Theme to Match
Homepage
Posted by "Michael Brooks (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CB-1033?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13415809#comment-13415809 ]
Michael Brooks commented on CB-1033:
------------------------------------
Rad Tim, looks like a good start.
I'd like to see the header match http://cordova.io (see {{/www/index.html}}).
As for navigation, I'm undecided on what is best. Personally, I'd like to see the document level navigation (e.g. Geolocation table-of-contents) as a sub-list to the document on the right-side. I think that would be the most straight-forward and clear approach. The downside is that we loose fixed position navigation, which can be handy for large documents.
Michael
> Update Documentation Theme to Match Homepage
> --------------------------------------------
>
> Key: CB-1033
> URL: https://issues.apache.org/jira/browse/CB-1033
> Project: Apache Cordova
> Issue Type: Bug
> Components: Docs
> Affects Versions: 2.0.0
> Reporter: Michael Brooks
> Assignee: Michael Brooks
> Fix For: 2.0.0
>
>
> Update the theme to match [cordova.io|http://cordova.io]
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Updated] (CB-1033) Update Documentation Theme to Match
Homepage
Posted by "Michael Brooks (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CB-1033?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Michael Brooks updated CB-1033:
-------------------------------
Affects Version/s: (was: 2.0.0)
Master
Fix Version/s: (was: 2.0.0)
Master
Bumping this to a future release.
> Update Documentation Theme to Match Homepage
> --------------------------------------------
>
> Key: CB-1033
> URL: https://issues.apache.org/jira/browse/CB-1033
> Project: Apache Cordova
> Issue Type: Bug
> Components: Docs
> Affects Versions: Master
> Reporter: Michael Brooks
> Assignee: Michael Brooks
> Fix For: Master
>
>
> Update the theme to match [cordova.io|http://cordova.io]
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira