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

   Thanks Neal! 
   
   - Yeah I think you're right about file renaming. It's not something I'm keen 
on myself, but found myself being pushed in that direction because of the scale 
of the rewrite. In some cases the content has changed so much that I'm not sure 
there's any meaningful continuity to be preserved. That being said, 
`install.Rmd` is a really good example of one that we should leave as-is. I 
think `dataset.Rmd` (which hasn't changed) is another one like that
   
   - I wonder if we can convert the vignettes to articles (in the pkgdown 
sense) so they don't get bundled in the build. It probably means we have to 
rewrite the cross-linking markdown since `vignette("whatever")` won't work 
anymore, but at some point I think we might have to make that change if we want 
to include images to help make the documentation readable to novice users?


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