010-new_to_markdown.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 / studying:

- 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.,  
- Grolemund, G., (2014). Hands-On Programming with R. O’Reilly, <https://github.com/rstudio-education/hopr>  
- Hengl, T., MacMillan, R.A., (2019). [Predictive Soil Mapping with R](https://soilmapper.org). OpenGeoHub foundation, Wageningen, the Netherlands, 370 pages, <https://soilmapper.org>, ISBN: 978-0-359-30635-0.  
- [RStudio](http://www.rstudio.com/products/RStudio/),  
- Wadoux, A.M.J.-C., Malone, B., McBratney, A.B., Fajardo, M., Minasny, B., (2021). [Soil Spectral Inference with R: Analysing Digital Soil Spectra Using the R Programming Environment](https://books.google.nl/books?id=4kQgEAAAQBAJ). Progress in Soil Science, Springer Nature, ISBN: 9783030648961, 274 pp.  

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