joss icon indicating copy to clipboard operation
joss copied to clipboard

add flowchart figure to docs?

Open danielskatz opened this issue 2 years ago • 4 comments
trafficstars

It might be helpful to add https://figshare.com/articles/figure/JOSS_publication_flowchart/5147773/2 to our docs somewhere for people who aren't familiar with how JOSS works.

danielskatz avatar Jul 13 '23 13:07 danielskatz

I'm not sure when it was added, but this is now in the docs so i think this can be closed? https://github.com/openjournals/joss/blob/b6e172fc9c7cbdfae350d819b165735da2b58d2a/docs/editing.md?plain=1#L333

sneakers-the-rat avatar Apr 17 '24 01:04 sneakers-the-rat

the figure there (which must have been added a long time ago and I missed somehow) is old - the one I pointed to is an update.

danielskatz avatar Apr 17 '24 07:04 danielskatz

aha, then i'll PR a change when back at desk. marking this notif as unread so i return to it

sneakers-the-rat avatar Apr 17 '24 07:04 sneakers-the-rat

How do we feel about using mermaid?

flowchart TB

    repo["Make software available in repository 
    with OSI-approved license"]
    paper["Author short markdown paper 📝"]
    submit["Submit to JOSS by 
    filling out short form"]
    eic_review["Editor-in-chief reviews size and
scope"]
    editor["Editor assigned"]
    reviewers["Editor assigns >=2 reviewers"]

    subgraph under_review [Review]
    review["Reviewers raise 
    comments and issues"]
    revise["Authors fix issues"]
    end

    accept["Editor accepts paper"]
    archive["Authors archive software"]
    published["Paper receives JOSS DOI"]

    status_submitted(["Submitted"])
    status_rejected(["Rejected"])
    status_under_review(["Under Review"])
    status_published(["Published"])

    style status_submitted fill:#007ec6,color:#fff;
    style status_rejected fill:#D4C5F9,color:#111;
    style status_under_review fill:#dfb317,color:#fff;
    style status_published fill:#4c1,color:#fff;

    repo --> paper 
    paper --> submit
    submit --> status_submitted
    status_submitted --> eic_review
    eic_review -- "Out of scope" --> status_rejected
    eic_review -- "In scope" --> editor
    editor --> reviewers
    reviewers --> status_under_review
    status_under_review --> under_review
    review --> revise
    revise --> review
    under_review --> status_rejected
    under_review --> accept
    accept --> archive
    archive --> published
    published --> status_published

sneakers-the-rat avatar Apr 20 '24 02:04 sneakers-the-rat