[ARROW-14059] [R] Further updates to arrow.Rmd vignette

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Won't Fix
• Component/s: Documentation, R
• External issue URL: https://github.com/apache/arrow/issues/29656
• Assignee: Unassigned
• Reporter: Nicola Crane
• Created: 21/Sep/21 16:42
• Updated: 11/Jan/23 08:37
• Resolved: 27/Oct/22 17:45

Description

Proposed updates:

• Define what is meant by "reader" and "writer" before using those terms
• Add some more code examples to the vignette to break up the text
• Remove backticks from package names to make it easier to skim (see dplyr vignette)
• Move "Object Hierarchy" and "Internals" sections" into their own vignette and link to it
• Break up the "Class structure and package conventions" section so that the code examples are in chunks rather than inline, and it's more skimmable.  Perhaps add subsections to help with this aim too.