Training bookdown for ADC

[vlraymond]

General guidelines for this book:

1. short chunks (no longer than 1 hr of content)
2. make things general / generic when possible

Known issues:

• how to manage content-specific datasets for training examples
• how to best attribute content created under other projects by other teams

Bookdown how to's:

bookdown webinar- https://www.rstudio.com/resources/webinars/introducing-bookdown/ bookdown guide - https://bookdown.org/yihui/bookdown/ Rmarkdown cheatsheet - https://www.rstudio.com/wp-content/uploads/2016/03/rmarkdown-cheatsheet-2.0.pdf

Other resources that could be useful

• https://software-carpentry.org/lessons/ (particularly the ones on R)
• http://www.datacarpentry.org/lessons/ (particularly ones on R and also the social science one that is in development)
• https://nceas.github.io/crescynt-training/data-rescue
• https://zenodo.org/record/28523 (Research data management training modules in Social Anthropology (Cambridge)))
• https://mantra.edina.ac.uk/ (MANTRA is a free online course for those who manage digital data as part of their research project.)
• https://zenodo.org/record/28544 (Digital Preservation for Researchers - teaching modules (Cambridge))
• https://nceas.github.io/sasap-training/materials/reproducible-analysis-in-r/
• https://nceas.github.io/oss-lessons/
• https://www.dataone.org/education-modules
• https://nceas.github.io/datateam-training/using-git-in-rstudio.html
• http://ohi-science.org/data-science-training/
• https://nceas.github.io/crescynt-training/data-integration
• http://bfe-inf.org/sites/default/files/doc-repository/Outline_Data_Skills_Curricula_Framework.pdf
  • http://www.the-iea.org/services/training-development/

Resource revied that don't prove that useful afterall

• http://www.icsu-wds.org/services/training-resources-guide
• https://www.sesync.org/for-you/educator/programs/short-courses
• http://dmtclearinghouse.esipfed.org/
• https://mozillascience.github.io/open-data-guides/
• http://commons.esipfed.org/datamanagementshortcourse

current questions:

1. New idea for chapter format of book - use the data life cycle categories as chapters.
2. Do we have a specific target audience for this book?

old / answered: Can we do gitbook? https://www.gitbook.com/editor Does VR have access to arctic-data-training repo?

[mbjones]

What would the advantages of that be? The nice thing about bookdown is that it is very easy to embed and execute R code as part of the tutorial docs. And there's really nice preview support in RStudio. Does gitbook support RMarkdown files, or just Markdown files?

[vlraymond]

Yes, you're right Matt. I watched a tutorial on Bookdown on Friday and came to the same conclusion.

[vlraymond]

bookdown-demo.pdf

[vlraymond]

^^^ draft as of 2/23/18.

Process so far: combing through existing content on training.arcticdata.io copying, combining, collating in to content for the book

next steps: refining and expanding existing content creating new content

[vlraymond]

bookdown-demo.pdf latest

[vlraymond]

determine:

• intended audience
• R users / technical users

[vlraymond]

other bookdowns in our NCEAS ecosystem that could be good resources

• https://nceas.github.io/datateam-training/using-git-in-rstudio.html
• https://nceas.github.io/sasap-training/materials/reproducible-analysis-in-r/

[vlraymond]

Having an issue pushing a branch to arctic-data-training repo. I am going to try again, and checking on my git config etc. Issue could be me, could also be my permissions to arctic-data-training

[vlraymond]

general guidelines:

• short (no longer than 1 hr of content)
• make things general / generic when possible

known issues:

• how to manage content-specific datasets for training examples

[vlraymond]

next step: VR needs to finally push this to the repo

[jagoldstein]

https://nceas.github.io/datateam-training/training/