RRR – Collaboration

Author

Søren O’Neill

Published

January 10, 2024

1 Samarbejde

1.1 Samarbejde med andre forskere

Tre scenarier :

  • Dine samarbejdspartnere bruger ikke R økosystemet (buh!)
  • Dine samarbejdspartnere bruger R økosystemet (juhuu!)
  • Du og dine samarbejdspartnere er hardcore nørder (git!)

1.2 Samarbejde med R-agnostikere

  • Render dine quarto dokumenter til Word eller OpenDocument fil formater … send dem via email eller brevdue
  • Samarbejdspartnerne bruger Track changes i deres foretrukne tekstbehandlingsprogram og … sender det tilbage
  • Du overfører relevante ændringer manuelt fra f.eks Word til qmd filen … i næste runde, gentages processen

Fordele

  • Simpelt
  • Ingen nye værktøjer at lære for dine R-agnostiske kolleger
  • Alle kan være med
  • Adskillelse af indhold og kommentarer

Ulemper

  • Hyppige fejl
  • Redundans
  • Versionerings mareridt
  • Fokus på typografi og opsætning

1.3 Samarbejde med R brugere

  • Send dem en kopi af dine qmd filer (data filer sov)
  • Samarbejdspartnerne redigerer direkte i qmd filerne og … returnerer dem
  • Diff de to versioner af qmd filerne og … selektiv sammenfletning

1.3.1 Diff’ af to (eller flere) tekst filer

Der er nogle meget fine programmer som gør det nemt at sammenligne to versioner af den samme tekst (qmd) fil og se _diff_erencerne:

  • Meld
  • Beyond compare
  • Araxis merge
  • P4Merge
  • DeltaWalker
  • ..og andre

Der er også flere online versioner som f.eks mergely … men du skal nok ikke uploade følsomme informationer.

Meld og andre diff programmer sammenligner forskellige filer og fremhæver forskellene imellem dem, så det er nemt at se ændringerne.

I dette simple eksempel, bruger vi Meld til at sammenligne to næsten identiske filer, version 1 og 2. Video viser en mindre ændring i en linje, en linje sletning og en linje tiføjelse i version 2 (højre side) i forhold til version 1.

Fordele

  • Relativt let
  • Nye værktøjer er nemme at lære at kende
  • Alle kan være med
  • Kun én filtype for alle samarbejdspartnere
  • Fokus på indhold

Ulemper

  • Stadig nogen redundans (qmd fil versioner)
  • Versionerings mareridt
  • Kommentarer og ændringer er ikke klart adskilt

Kopier disse to tekster (en ad gangen) og indsæt dem i hhv højre og venstre felt på denne side

Version 1

This text is almost similar to the other one. But not completely identical.

Some lines are identical.

Some lines have disappeared.

Version 2

This text is almost similar to the other one, but not completely identical.

Some lines are identical.

Some lines are brand new

1.4 Teknologi kyndige samarbejdspartnere

Brug et online GIT repositorie som github eller SDUs gitlab server – du skal kontakte IT support for at få en bruger konto.

Fordele

  • Top klasse reproducible research
  • Verdens bedste versionerings system
  • Ingen redundans og en smuk og ren arbejdsfolder

Ulemper

  • Lad os bare indrømmet det – læringskurven kan være lidt stejl :-)