AlenkaF commented on PR #36591:
URL: https://github.com/apache/arrow/pull/36591#issuecomment-1708533789

   I had some issues displaying the version warnings on the newly built docs 
from this PR when testing locally. Instead of spending more time debugging I 
decided to test a new feature in the development version of the pydata sphinx 
theme. A PR has been merged in July adding a version warning bar: 
https://github.com/pydata/pydata-sphinx-theme/pull/1354.
   
   It is a bit different from what we currently have. The difference is that in 
our current case we display a separate warning for developer docs pointing to 
the development version as the preferred one.
   
   But the version warnings bar in the pydata sphinx theme is nicer IMO and it 
makes our code much much easier to maintain.
   
   I am adding two images to show the difference between the current version 
warnings bar we have and the version warnings bar included in the theme:
   
   
   ![Screenshot 2023-09-06 at 15 48 
59](https://github.com/apache/arrow/assets/16418547/3cec16f6-8eab-4acd-b120-88b144546e18)
   
   
   ![Screenshot 2023-09-06 at 15 48 
54](https://github.com/apache/arrow/assets/16418547/ef877309-d58b-44bf-9ed5-3bb79ffadf0a)
   
   
   I prefer the latter (pydata sphinx theme version warning bar).


-- 
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]

Reply via email to