search

biostars / biostar-handbook

Issue tracker for the Biostar Handbook
57 stars 12 forks source link

Guide for contributions #99

Closed bsipos closed 4 years ago

bsipos commented 4 years ago

Is there a guide for contributing to the BioStars books?

ialbert commented 4 years ago

yes we have a guide to contributing on the following page:

https://www.biostarhandbook.com/about-the-author.html

bsipos commented 4 years ago

I would like to potentially contribute (again). Could you try giving me access to the source? It did not work last time for some reason but maybe the second time is the charm. :)

ialbert commented 4 years ago

currently, the goal is to make the book is a separate repository, where everyone can set it up however they want it. The mono-repository was too hard to deal with. We are slowly migrating all content to individual books.

So the recommended practice for adding new pages on any content is very straightforward, make a repo public or private (if private allow us to pull from).

Generate markdown files into it with any editor you wish and we'll clone your repo and add link your contents to the table of contents.

For fixing up new content tell us which chapter you want to work on and we can either let you edit that repo or if the refactoring is not yet done we'll start that.

bsipos commented 4 years ago

That sounds like a sensible approach when in full swing. Will the markdown for the different books be available for folks who want to do fixes later on? It would make things easier.

ialbert commented 4 years ago

I have not thought of that yet, needs to be evaluated,, the prior experiment in allowing people to work on the book was partially successful, the vast majority did not contribute in the end.

bsipos commented 4 years ago

Well, nevermind. Indeed if there is a will, there is way. :)