Document your data
Documenting data in R package development is crucial as it provides essential information about the datasets included in the package. Proper documentation helps users understand the structure, content, and intended use of the data, enabling them to make informed decisions and effectively utilize the package's functionality.
Recall the distance_data
data set you loaded into the package earlier in the course.
The testthat
package and the unitConverter
package at this point in development have been loaded for you. You are currently working in the R/distance_data.R
file that was created with use_r("distance_data")
.
This exercise is part of the course
Developing R Packages
Exercise instructions
- Update the heading to have a title of
Distance values and units
and a description ofDistance values and corresponding unit (feet, meters, or inches)
- Update the
@format
entry to beData frame with two columns and 1000 rows
. - Change the
\describe
portion to includevalue
andunit
as\item
s withNumeric distance value
andDistance unit
as information. - Add an
@examples
entry showing how to printdistance_data
and close the file with the name of the data in a string.
Hands-on interactive exercise
Have a go at this exercise by completing this sample code.
# Add header and description
___
___
___
# Update format
___
# Document column names and information
#' \describe{
___
___
#' }
# Add example and string of data name
___
___
___