djnavarro commented on PR #14514:
URL: https://github.com/apache/arrow/pull/14514#issuecomment-1292688946

   
   > All that said though, you could make the argument that whilst navigating 
between docs for different versions of a function may be desirable, it might be 
less important for vignettes, and so we could just link to the articles index 
page in those cases.
   
   After thinking about it for a little I'm starting to think this might be the 
best approach to vignette linking across versions. The structure of the 
vignettes has changed quite a bit in this rewrite, and there's not really a 1:1 
mapping between old and new. I was unhappy about it because I hate breaking 
backwards compatibility even in the docs, but it's not like we could fix the 
issue with a simple file rename -- the underlying content is different enough 
in some cases that there's nothing useful to be gained by pretending that the 
old "get started" vignette is meaningfully the same document as the new one? So 
yeah maybe we just map to the "articles" page, since that's guaranteed to be 
structurally the same thing in every release?
   


-- 
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: github-unsubscr...@arrow.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to