Repository files navigation

TheJournal of Open Source Software (JOSS) is a developer friendly journal for research software packages.

The Journal of Open Source Software (JOSS) is an academic journal with a formal peer review process that is designed toimprove the quality of the software submitted. Upon acceptance into JOSS, a CrossRef DOI is minted and we list your paper on the JOSS website.

In a perfect world, papers about software wouldn't be necessary. Unfortunately, for most researchers, academic currency relies on papers rather than software and citations are, thus, crucial for a successful career.

We built this journal because we believe that after you've done the hard work of writing great software, it shouldn't take weeks and months to write a paper¹ about your work.

We have a simple submission workflow and extensive documentation to help you prepare your submission. If your software is already well documented then paper preparation should take no more than an hour.

¹ After all, this is just advertising.

The JOSS submission tool is hosted athttps://joss.theoj.org

If you're looking for the JOSS reviews repository head over here:https://github.com/openjournals/joss-reviews/issues

In order to have a more open and welcoming community, JOSS adheres to a code of conduct adapted from theContributor Covenant code of conduct.

Please adhere to this code of conduct in any interactions you have in the JOSS community. It is strictly enforced on all official JOSS repositories, the JOSS website, and resources. If you encounter someone violating these terms, please let the Editor-in-Chief (@arfon) or someone on theeditorial board know and we will address it as soon as possible.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

PostgreSQL andElasticsearch should be installed and running locally for JOSS to work

1. Install packages with bundler -bundle install
2. Set rails env in your shell (or prepend to each command):export RAILS_ENV=development
3. Create the database withbin/rails db:create
4. Run any pending db migrationsbin/rails db:migrate
5. (Optional) seed the data with demo data (seedb/seeds.rb)bin/rails db:seed
6. After running elasticsearch, create an index withcurl -X PUT http://localhost:9200/joss-productionNote - you may need to disable the default security settings of elasticsearch by editing yourconfig/elasticsearch.yml
7. Create search indexes:bin/rails searchkick:reindex:all
8. Runbin/rails s

You may encounter an error on startup like:

Started GET "/" for 127.0.0.1 at 2024-08-15 13:03:02 -0700objc[41226]: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called.objc[41226]: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug.

To resolve it, either in your shell file or in the shell itself add:

export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES

Seerails#38560