nchammas opened a new pull request, #700:
URL: https://github.com/apache/spark-website/pull/700

   Right now if you look at a page on the main website like [Useful Developer 
Tools][current], you'll notice that you cannot easily click on a heading and 
get an HTML anchor that will let you link directly to that section. On the 
other hand, if you look at the [programming docs][prog], you'll see that you 
_can_ get anchor links by mousing over a heading.
   
   This discrepancy is because [the programming docs include AnchorJS][anch], 
whereas the main website does not.
   
   This PR adds AnchorJS to the main docs so readers can easily link to 
headings there like they can on the programming docs:
   
   <img width="500" 
src="https://github.com/user-attachments/assets/b15071c2-ba83-4502-9166-e8439696df7c";
 />
   
   This adds the [latest release of AnchorJS][rel], which is 5.0.0. The 
programming docs are [on AnchorJS 1.1.1][old], which is more than 11 years old. 
In a matching PR, I will update the programming docs to also use AnchorJS 5.0.0 
so they are consistent.
   
   I built the docs locally and confirmed that the anchors work as expected.
   
   [current]: https://spark.apache.org/developer-tools.html
   [prog]: https://spark.apache.org/docs/latest/
   [anch]: 
https://github.com/apache/spark/blob/392dd8dc39b2d6bb3fb341901cb27d4d7103dc34/docs/_layouts/global.html#L199
   [rel]: https://github.com/bryanbraun/anchorjs/releases
   [old]: 
https://github.com/apache/spark/blob/44c931f006194a833f09517c9e35fb3cdf5852b1/docs/js/vendor/anchor.min.js#L2


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to