[
https://issues.apache.org/jira/browse/SPARK-8352?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15011713#comment-15011713
]
Josh Rosen commented on SPARK-8352:
-----------------------------------
If we move to Bootstrap 3, that should be done as its own separate PR
independent of the changes here.
IMO, the exact styling isn't important because I don't think that's the hard
part of getting this to work. AFAIK, when I last looked at this the hard part
was getting the generated HTML into a form that contained the right anchors,
etc. for the affix TOC stuff. How are you handling that? I'd like to focus on
that harder part first and deal with styling questions once we know that the
scrolling / behavioral aspects of this work correctly.
> Affixed table of contents, similar to Bootstrap 3 docs
> ------------------------------------------------------
>
> Key: SPARK-8352
> URL: https://issues.apache.org/jira/browse/SPARK-8352
> Project: Spark
> Issue Type: Sub-task
> Components: Documentation
> Reporter: Josh Rosen
> Priority: Minor
> Attachments: screenshot-1.png, sidebar2.1.0.png
>
>
> Some of our documentation pages are getting kind of long and hard to
> navigate. Bootstrap 3's documentation
> (http://getbootstrap.com/getting-started/) has a nice solution for this:
> their table of contents stays with you on the side of the page as you scroll
> and its subheaders expand / collapse based on your scroll position, making it
> easy to know where you are in the document.
> We should consider doing this for our docs, too, although it may require some
> more involved post-processing steps in Jekyll in order to insert the right
> DOM elements so that the scrollspy / affix stuff works properly.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]