BACTpipe icon indicating copy to clipboard operation
BACTpipe copied to clipboard

Update citation/publish pipeline

Open thorellk opened this issue 5 years ago • 25 comments

With the 3.0 release we should update the Zenodo citation so that the correct people are acknowledged. Should we also try to publish the pipeline as some kind of short communication? Or is that to aim too high?

thorellk avatar Jan 14 '21 11:01 thorellk

I think that this makes sense. While working on my masters, I realized that referencing book/articles is much easier than referencing source code and repositories. When I came across this pipeline I loved this idea and release my own work via zenodo https://zenodo.org/record/4294795

I do think that academically speaking an updated citation for the latest stable version makes things more authentic.

abhi18av avatar Jan 14 '21 17:01 abhi18av

And I'm also in favor of following this up with a short communication as well.

abhi18av avatar Jan 14 '21 17:01 abhi18av

I can't remember exactly since it was a while since I set it up, but I think that if we make a release here on github it will be very easy to assign a new DOI using that release.

boulund avatar Jan 15 '21 09:01 boulund

That makes sense, it's almost like a CI/CD. Btw, I'm curious does it parse the commits for list of people who have contributed?

image

abhi18av avatar Jan 15 '21 12:01 abhi18av

Yes, I think it does

boulund avatar Jan 15 '21 12:01 boulund

When you've tested that everything works for the 3.0 release in the main branch and all the docs have hade their final touches, can you make a release on github so I can link it into Zenodo?

boulund avatar Jan 16 '21 08:01 boulund

Was there ever any resolution to this? It seems that the docs have been updated already. I am asking as I will be starting to write my thesis very soon and having a DOI then, by which to cite the work with BACTpipe 3.0, would be great.

emilio-r avatar Mar 23 '21 09:03 emilio-r

Someone just needs to make a new release on Github so we can attach a new Zenodo DOI to that release.

boulund avatar Mar 23 '21 09:03 boulund

Once we merge the pending changes from the develop branch into the main branch I'll make a new release and update the Zenodo stuff

boulund avatar May 05 '21 06:05 boulund

Hooray 😄

Now when we're happily done with 3.1 maybe it is time to update the citation?

thorellk avatar May 07 '21 12:05 thorellk

https://zenodo.org/record/4742358#.YJUyvbX7Q-U

boulund avatar May 07 '21 12:05 boulund

I think we missed the citation in the docs, https://bactpipe.readthedocs.io/en/latest/#citing-bactpipe

can someone make a commit fixing that?

boulund avatar May 07 '21 12:05 boulund

Hmm, seems like Sandra is left out and the naming scheme is quite weird, mixing GitHub user id's and full names, including capitalized ones. I guess this is collected from the GitHub user information? Is there any way of editing this?

thorellk avatar May 07 '21 12:05 thorellk

Yes, it automatically collects the names/usernames of everyone who has contributed commits. It seems we can edit it manually if we want to. We just need to decide which authors should be there and in which order.

boulund avatar May 07 '21 12:05 boulund

Emilio Rudbeck; Abhinav Sharma; Yue Hu; Joseph Kirangwa; Emilyn Costa Conceição; Sandra Álvarez-Carretero; Fredrik Boulund; Kaisa Thorell? Or if you want to be the last?

thorellk avatar May 07 '21 12:05 thorellk

That looks fine with me, I'll update the citation on Zenodo and in the docs right away.

boulund avatar May 07 '21 13:05 boulund

I have updated the Zenodo citation and the citation on the first page of the docs, and synced the little commit from master to develop, so we can continue with feature branches from develop for future developments.

boulund avatar May 07 '21 13:05 boulund

@emilio-r and @abhi18av, were you interested in writing something on the pipeline as well to publish it as some kind of paper?

thorellk avatar May 07 '21 13:05 thorellk

@boulund you forgot Sandra! She was the original author of BACTpipe and even if much has changed since I still think she should be included.

thorellk avatar May 07 '21 19:05 thorellk

I don't understand what you mean, Sandra is included? image

boulund avatar May 08 '21 13:05 boulund

I think, that this might be because of the confusion with older Zenodo DOI.

Should we mention the project DOI instead of the release DOI?

1254247

Screenshot 2021-05-09 at 9 29 23 AM

abhi18av avatar May 09 '21 07:05 abhi18av

@emilio-r and @abhi18av, were you interested in writing something on the pipeline as well to publish it as some kind of paper?

Yup, that'd be great. Perhaps a short publication explaining the workflow and the chioces behind this?

abhi18av avatar May 09 '21 07:05 abhi18av

It should be the project DOI (that always points to the latest release on Zenodo) that is embedded in the README

image points to https://zenodo.org/badge/latestdoi/83326100

boulund avatar May 09 '21 07:05 boulund

Sandra was missing in the docs, not in the Zenodo doi. Sorry for not being clear, I added it now :)

thorellk avatar May 09 '21 18:05 thorellk

First: Huzzah to having released 3.1! :tada:

@emilio-r and @abhi18av, were you interested in writing something on the pipeline as well to publish it as some kind of paper?

Yes, writing something would be a good way to cap this whole experience. Next week I may find some time as my thesis will be in for review. Then I could probably write together a shorter draft on BACTpipe to share for general review and comments, unless anyone else feels like writing, or have another suggestion for how to do this.

emilio-r avatar May 10 '21 07:05 emilio-r