Good-Code Reuse with GitHub & R

Update & How You Can Contribute

@mauro_lepore

Overview

My goal: to learn how I can help you

  • Show progress and outline future direction

  • Show how you can contribute

  • Discussion focused on the why and what, not how

  • Mechanics via listed resources or see me later

Do you use the CTFS R package? What functions?

Update

forestgeo & forestr

A good system lets you fail safely

Fast failure means fast feedback

You should fall effortlessly into the pit of success

GitHub

github.com/forestgeo

You may have a good system already

Real projects are complex

Is there a better system?

GitHub gives you research super-powers

Data and metadata stay synchronized

We have public and private repos (see enterprise)

R packages

github.com/forestgeo/forestr

The single biggest way to improve both the quality of your code and your productivity is to reuse good code.

Wouldn't this be nice?

devtools::create("bci") r-pkgs.had.co.nz

How You Can Contribute

Share R products: they are easy to publish

Publish publicly

Publish privately

File issues (template)

Issues: use your account or forestgeoguest

Contribute code

Get emails about packages you like

Keep updated

Summary

You already have some new tools

More tools are comming

You have multiple ways to help

Stay tuned

Thank you all; also thanks to:

Supported the project with code or ideas:

Gabriel Arellano, Sabrina Russo, SeanMcMahon and lab, Suzanne Lao, Kristina Teixeira and other participants of the databases workshop 2017, Stuart Davies.

.

Supported me with administration:

Smithsonian HR, Adriana Bilgray and team, Haley Overstreet, Lauren Krizel.

Discussion

@mauro_lepore

We may also meet during this workshop

Resources

end

Topics that may be useful to share

  • project management (RStudio, r projects and packages)
  • github
  • tidyverse

Tips that may be useful to share

  • how to find stuff
  • recommend use of tags (shortcut Ctrl+Alt+x)
  • reprex::reprex()
  • shortcuts, how to find all of them and
  • cheetsheets
  • webinars
  • free private repositories on github academic
  • free private repositories on bitbucket
  • how to create a package
  • tidyr
  • dplyr
  • readr
  • ggplot2
  • write an outline of your script with
    • sections Ctrl + Shift+ O
    • and shortcut Ctrl + Shift + O
  • package data

Misc

xxxcont.

  • Show how to pull request edits to documentation and code

  • shall we have meetings during this workshop?