Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[SPARK-8353] [DOCS] Show anchor links when hovering over documentation headers #6808

Closed
wants to merge 3 commits into from

Conversation

JoshRosen
Copy link
Contributor

This patch uses AnchorJS to show deep anchor links when hovering over headers in the Spark documentation. For example:

image

This makes it easier for users to link to specific sections of the documentation.

I also removed some dead Javascript which isn't used in our current docs (it was introduced for the old AMPCamp training, but isn't used anymore).

@JoshRosen JoshRosen changed the title [SPARK-8353] Show anchor links when hovering over documentation headers [SPARK-8353] [DOCS] Show anchor links when hovering over documentation headers Jun 14, 2015
@JoshRosen
Copy link
Contributor Author

/cc @pwendell, this might be nice to port back to the 1.4.x docs as well, since it's a big doc UX improvement.

@SparkQA
Copy link

SparkQA commented Jun 14, 2015

Test build #34856 has finished for PR 6808 at commit f518b6a.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@JoshRosen
Copy link
Contributor Author

By the way, I've filed https://issues.apache.org/jira/browse/SPARK-8351 as an umbrella to track ideas for a few similar non-content documentation improvements, including improvements to other navigational aids.

@JoshRosen
Copy link
Contributor Author

The underline on hover looks a little strange, so I'm going to push a CSS fix to address that.

@SparkQA
Copy link

SparkQA commented Jun 18, 2015

Test build #35153 has finished for PR 6808 at commit e59d8a7.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@JoshRosen
Copy link
Contributor Author

I'm going to merge this into master and branch-1.4 so that we have the nice links for 1.4.1. If we want to make more CSS tweaks, we can do it in a followup PR.

asfgit pushed a commit that referenced this pull request Jun 18, 2015
…n headers

This patch uses [AnchorJS](https://bryanbraun.github.io/anchorjs/) to show deep anchor links when hovering over headers in the Spark documentation. For example:

![image](https://cloud.githubusercontent.com/assets/50748/8240800/1502f85c-15ba-11e5-819a-97b231370a39.png)

This makes it easier for users to link to specific sections of the documentation.

I also removed some dead Javascript which isn't used in our current docs (it was introduced for the old AMPCamp training, but isn't used anymore).

Author: Josh Rosen <joshrosen@databricks.com>

Closes #6808 from JoshRosen/SPARK-8353 and squashes the following commits:

e59d8a7 [Josh Rosen] Suppress underline on hover
f518b6a [Josh Rosen] Turn on for all headers, since we use H1s in a bunch of places
a9fec01 [Josh Rosen] Add anchor links when hovering over headers; remove some dead JS code

(cherry picked from commit 44c931f)
Signed-off-by: Josh Rosen <joshrosen@databricks.com>
@asfgit asfgit closed this in 44c931f Jun 18, 2015
nemccarthy pushed a commit to nemccarthy/spark that referenced this pull request Jun 19, 2015
…n headers

This patch uses [AnchorJS](https://bryanbraun.github.io/anchorjs/) to show deep anchor links when hovering over headers in the Spark documentation. For example:

![image](https://cloud.githubusercontent.com/assets/50748/8240800/1502f85c-15ba-11e5-819a-97b231370a39.png)

This makes it easier for users to link to specific sections of the documentation.

I also removed some dead Javascript which isn't used in our current docs (it was introduced for the old AMPCamp training, but isn't used anymore).

Author: Josh Rosen <joshrosen@databricks.com>

Closes apache#6808 from JoshRosen/SPARK-8353 and squashes the following commits:

e59d8a7 [Josh Rosen] Suppress underline on hover
f518b6a [Josh Rosen] Turn on for all headers, since we use H1s in a bunch of places
a9fec01 [Josh Rosen] Add anchor links when hovering over headers; remove some dead JS code
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants