Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Very first draft #6

Open
rougier opened this issue Jul 25, 2016 · 7 comments
Open

Very first draft #6

rougier opened this issue Jul 25, 2016 · 7 comments

Comments

@rougier
Copy link
Member

rougier commented Jul 25, 2016

Hi all,

I've uploaded a very first and incomplete draft but I won't have much time to work further on it until 2 to 3 weeks. If anyone feel to work on it...

@khinsen
Copy link

khinsen commented Sep 12, 2016

This draft looks very good to me, being essentially a fleshed-out version of the outline in #4.

Before improving details, I think we should think about two questions:

  1. What is the central message of the article?
  2. Who is our main audience?

Some candidates for the central message:

  • Advertising/increasing visibility: This is our new ReScience journal, wouldn't you want to publish something there?
  • The reproducibility problem in computer-aided research: overview of the problem and proposed solutions/tools, followed by a summary of our own approach.
  • The value of publishing replications: Here's how reviewing replications in ReScience has worked out in practice, and the benefits we believe it brings to science.

I suspect we all hope for ReScience getting more exposure through this article, but then this is not the role of peer-reviewed articles, so it cannot be the central message in my opinion. The other two candidates are valid choices for a peer-reviewed paper. But we should be careful to focus on one or the other, otherwise referees will justly criticize the paper for lack of focus.

My personal favorite is the last one.

@oliviaguest
Copy link
Member

oliviaguest commented Sep 12, 2016

I just have read through the 1st and (just glanced at the) 2nd sections. I have just made a PR for some small typos/spelling mistakes in the intro (see: #10 - which I just saw has been accepted! Thanks @rougier! 😄 ).

More broadly, I think the English needs reformatting and help both along the lines of rephrasing conceptually and grammatically. This will inevitably bring the size down (which is always useful) and clarify the arguments and raise questions (which are also both useful). I don't think this is that much work per se, but given there are many authors such rephrasing endeavours require more thought and compromise.

Does anybody have any objections to me reading it all over soon and proposing some more changes? I don't know what the rules are for authorship – have I missed an important relevant thread?

@rougier
Copy link
Member Author

rougier commented Sep 12, 2016

Good for me if you can correct my (bad) english !

For the authorship, I've sent a mail to all editors, reviewers (that have reviewed) and published authors. Among these, I took the name of those who declared some interest by watching the thread. The order is pretty much random at the moment. And we may have more authors in the end. I'll send another email I think.

@rougier
Copy link
Member Author

rougier commented Sep 13, 2016

@khinsen I agree with you that we cannot write an article solely for advertising the journal and your third point (The value of publishing replications: Here's how reviewing replications in ReScience has worked out in practice, and the benefits we believe it brings to science.) makes perfect sense to me.

At this point, I'm not sure how to structure the paper around this message. Most certainly in the introduction and the conclusion but ideas welcome.

@rougier
Copy link
Member Author

rougier commented Oct 7, 2016

Is someone working on the article right now ?

@oliviaguest
Copy link
Member

I am not but I still need to go through it. It's on my todo list.

Tangentially, has there been a discussion of where to publish this that I have missed?

@rougier
Copy link
Member Author

rougier commented Oct 9, 2016

Yes, it's issue #3. If you have more suggestion, that would be great.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants