reciproceed : recipe, proceed, reciprocally

[This article was first published on Guillaume Pressiat, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

use R, YAML and bookdown to automate generation of procedure books

Context: How to do this thing that only your colleague does when he’s not here?

I recently put on github a project that contains a little framework to list procedures in a structured way that can be shared with all your colleagues or buddies.

You may know situations where someone in your team has build a project that he is the only one to mastering. How to make it works when he is not here ? Maybe he has written a doc / procedure that explains his project but you don’t know (or don’t remember) where it is on the network (or on the web)?

As a solution, an index of all procedures can be useful, one that lists:

  • summary of all procedures (as simple steps)
  • links to git repositories
  • links to more detailed procedures (docx, pdf, html)
  • links to data sources used by projects
  • etc.

reciproceed sounds like “reciprocally” meaning that once all procedures are listed this way, all the team will be involved reciprocally.

Idea

To do this, an idea is: using a YAML file and bookdown to build a shareable procedure listing like a book.

Example

As an example, I collected some soup recipes and fake procedures, see the source YAML file.

Soup recipes are used as fake data (meaning that they are structured and have chronological steps like procedures) but they are not fake soups. By the way they came from bbcfoods.

And the result book is here:

Soup recipe example

Maybe

Maybe someone else will be interested by this and even will participate to improve it.

It’s here, https://github.com/GuillaumePressiat/reciproceed

To leave a comment for the author, please follow the link and comment on their blog: Guillaume Pressiat.

R-bloggers.com offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

Never miss an update!
Subscribe to R-bloggers to receive
e-mails with the latest R posts.
(You will not see this message again.)

Click here to close (This popup will not appear again)