[ 
https://issues.apache.org/jira/browse/ARROW-5452?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16852262#comment-16852262
 ] 

Neal Richardson commented on ARROW-5452:
----------------------------------------

If only .Rmd was the documentation format that R used. R man pages are .Rd 
format, which is a flavor of TeX. I can't imagine that it's worth our trouble 
to reimplement everything that `pkgdown` does to parse those and crossreference 
across those and various other (mostly markdown) pages. Plus, the pkgdown site 
style is familiar to R users, just as sphinx is for Python users. It's better 
for the intended audience of the docs. 

[https://arrow.apache.org/docs/js/] and [https://arrow.apache.org/docs/java/] 
already exist, so it doesn't seem unreasonable to add R to that. We can (and 
should) have links to those other languages in the sphinx /docs/ ToC sidebar.

 

> [R] Add documentation website (pkgdown)
> ---------------------------------------
>
>                 Key: ARROW-5452
>                 URL: https://issues.apache.org/jira/browse/ARROW-5452
>             Project: Apache Arrow
>          Issue Type: Improvement
>            Reporter: Neal Richardson
>            Assignee: Neal Richardson
>            Priority: Major
>             Fix For: 0.14.0
>
>
> pkgdown ([https://pkgdown.r-lib.org/]) is the standard for R package 
> documentation websites. Build this for arrow and deploy it at 
> https://arrow.apache.org/docs/r.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to