search

fair-cookbook / the-fair-cookbook

2 stars 2 forks source link

explain where this project is #5

Open jcolomb opened 4 years ago

jcolomb commented 4 years ago

Is your feature request related to a problem? Please describe. As a newcomers, it seems the book only contains information about how to write the book, but no content (yet). Is this true?

Also it seems the tool presented are very python specific (?). Will it stay like this?

Describe the solution you'd like Maybe mentioning at the beginning where the project stands and whether it makes sense for us to start reading it would be helpful.

proccaserra commented 4 years ago

@jcolomb thx for the feedback. The main site for this project is actually here: https://github.com/FAIRplus/the-fair-cookbook. which is rendered here: https://fairplus.github.io/the-fair-cookbook/intro.html

with our dev version (richer content, we are about to release to prod): https://fairplus.github.io/cookbook-dev/intro.html :

But to answer your question, i.e. the content being "python-specific". Our developers have diverse background and expertise, with R, Python, Ruby and Java. We will be posting what people contribute, ideally in the form of hands-on executable notebooks.

Also, the intent is also to provide more strategical overviews so not all the content will be necessarily very technical (ie. down to code execution).

We'd be interested in hearing from your needs and what you'd like to see covered that we have missed.

ghost commented 4 years ago

Hi Julien @jcolomb , I can only second that. Great that you discovered this repo, though it's only a "left-over"... If you want to I would be happy to exchange on your thoughts on its fit for your purpose; I am also Berlin-based, if that helps anything in Corona times. ;) Best, Robert

jcolomb commented 4 years ago

hey, I was only browsing around when I found this, and I am still not sure what to take from it. the new intro is much clearer, and I think I will get it when I get a real example.

By the way, blogdown has a way to add a link to the editable version of each page on github, which I always find handy. maybe there is one with jupyter-book?

proccaserra commented 4 years ago

Currently testing migration from legacy jupyter-book to version 0.7. growing pains

ghost commented 4 years ago

hey there! We are actually just today on making intro landing pages for different target audiences, to make it clearer.

Main message: We are developing recipes to guide you through a FAIRification process.

Agreed on the editing link, would love to see that, too! I'll put it on our eternally growing todo list. ;)

ghost commented 4 years ago

@jcolomb : could you share your first-time thoughts when you hear "FAIR cookbook"? What did you expect to find?

jcolomb commented 4 years ago

hey @robertgiessmann that is a good question. I think I was expecting a walkthrough to get data more FAIR, the "recipes" terminology got me a bit lost, especially because I saw a lot of relation to chemistry ontologies at first. At some point, I wondered if we were actually talking about FAIR principles for data or something else...

I thought it would be less data specific (it seems you tend to go to one recipe for each data type ?) and have an easier start for non-technical people.

PS: we have a new open science meetup next week, "post" corona, limited crew, would be nice to see you again!

ghost commented 4 years ago

oh really (about open science meetup) ! That slipped obviously my attention... Are links allowed here? Could you send me more info to rgiessmann@gmail.com ?

ghost commented 4 years ago

Regarding the expectation management: we are currently thinking hard about how to enable people to get started. We kind of got lost there, and came to think about "user personas". If we developed this idea further, maybe I could interview you a little? Best!