010-start_here.Rmd

# New to markdown

```{r, results = "asis", echo = FALSE}
status("drafting")
```

## Clone, add reference, submit merge request...

To add a new dataset, please follow these steps:

1.  Click on the edit button on the book homepage,\
2.  Login to Github.com and select "Start a pull-request",\
3.  Add new references to `020-dataset_list.Rmd` and save,\
4.  Commit and push and make a [pull
request](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request).\
5.  Once received we will check it and if you have followed the instructions closely, 
    the reference will appear in the document as soon as the code is merged with the master,\

```{r pull-request, echo=FALSE, fig.cap="Example of a pull request on Github.com.", out.width="50%"}
knitr::include_graphics("img/example_pull_request.jpg")
```

If you're new to markdown and want to learn how to use it, please refer to [this tutorial](https://guides.github.com/features/mastering-markdown/).

If you are new to R and/or [**pedometrics**](https://pedometrics.org), please consider reading / installing:

- Kabacoff, R.I., (2011) ["R in Action: Data Analysis and Graphics with R"](http://www.manning.com/kabacoff/). Manning publications, ISBN: 9781935182399, 472 pages.
- California Soil Resource Lab, (2017) ["Open Source Software Tools for Soil Scientists"](https://casoilresource.lawr.ucdavis.edu/software/), UC Davis.,  
- [RStudio](http://www.rstudio.com/products/RStudio/),

If you'd like more of a roadmap to guide you through R, have a look at Oscar's blogpost:

- <https://oscarbaruffa.com/a-roadmap-for-getting-started-with-r/>  


## Video Course: Getting started with R

If you prefer video instruction with progress tracking:

- <https://rfortherestofus.com/courses/getting-started/>