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

Scope updates #585

Open
wants to merge 6 commits into
base: searchkick
from

Conversation

@arfon
Copy link
Member

commented Aug 16, 2019

Adding submission scope section to site.

cc @openjournals/joss-eics @labarba

@arfon arfon referenced this pull request Aug 16, 2019

Open

Add "Scope" to About page #582

@danielskatz

This comment has been minimized.

Copy link
Collaborator

commented Aug 16, 2019

When I look at the files changed here, this doesn't make sense - it's just removing a lot of requirements and then changing the name from requirements to scope. Is this part of something else I need to look at as well?

@arfon

This comment has been minimized.

Copy link
Member Author

commented Aug 16, 2019

When I look at the files changed here, this doesn't make sense - it's just removing a lot of requirements and then changing the name from requirements to scope. Is this part of something else I need to look at as well?

@danielskatz - I'm trying to address #582 in this pull request. @labarba's (very reasonable) feedback in #582 on my first attempt to address this was that we don't really want to repeat the about page content here, rather, we want to make it clear what submissions are considered in scope for JOSS.

@danielskatz

This comment has been minimized.

Copy link
Collaborator

commented Aug 16, 2019

I see, this is a fix to a previous attempt, not a fix to the site as it was - that's what was confusing me. Go ahead and merge from my point of view, though I might make a small suggestion for a further tweak afterwards

@danielskatz

This comment has been minimized.

Copy link
Collaborator

commented Aug 16, 2019

Well, on second thought, I like some of the stuff that's there now, before the PR is merged. Can we keep:

  • The software should be open source as per the OSI definition.
  • The software should have an obvious research application.
  • The software should be feature-complete (no half-baked solutions) and designed for maintainable extension (not one-off modifications). Minor ‘utility’ packages, including ‘thin’ API clients, are not acceptable.

there.

And I think the part that now says
👀Learn more about the JOSS submission process ⟶
should really say
👀Full details about JOSS submission requirements and the JOSS submission process ⟶

@danielskatz

This comment has been minimized.

Copy link
Collaborator

commented Aug 16, 2019

Also maybe move the bullets under the text paragraph?

So, how about:

Scope & submission requirements:

JOSS publishes articles about research software. This definition includes software that: solves complex modeling problems in a scientific context (physics, mathematics, biology, medicine, social science, neuroscience, engineering); supports the functioning of research instruments or the execution of research experiments; extracts knowledge from large data sets; offers a mathematical library, or similar.

JOSS submissions must:

  • Be open source (having an OSD-compliant license)
  • Have an obvious research application
  • Be feature-complete (no half-baked solutions) and be designed for maintainable extension (not one-off modifications)
  • Not be minor ‘utility’ packages, such as ‘thin’ API clients

👀Full details about JOSS submission requirements and the JOSS submission process ⟶

We also might want to change the corresponding bullets in readthedocs to match, if we make changes to their language here

@arfon

This comment has been minimized.

Copy link
Member Author

commented Aug 16, 2019

👍to those suggestions @danielskatz.

@arfon arfon temporarily deployed to joss-production Aug 16, 2019 Inactive

@arfon

This comment has been minimized.

Copy link
Member Author

commented Aug 16, 2019

FYI, I deployed this PR so we could see how it looks live: https://joss.theoj.org/about#submitting

@arfon arfon temporarily deployed to joss-production Aug 16, 2019 Inactive

danielskatz and others added some commits Aug 16, 2019

@arfon arfon temporarily deployed to joss-production Aug 16, 2019 Inactive

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
4 participants
You can’t perform that action at this time.