Add guidelines for how to cite Jupyter and its subprojects, and which papers are canonical ones for citation

[akhmerov]

Jupyter must provide users and readers with guidelines for how to cite Jupyter publications. This will reduce the cognitive load and confusion associated with giving credit to the project (and sub-projects) in scholarly publications.

Jupyter has authorship guidelines for writing papers, but this doesn't provide guidelines for citing papers. We need to define a lightweight policy for "which paper can make it onto the Jupyter website", as well as implement a place for where they go.

Next actions

• Define a policy for deciding whether a paper should be listed on the Jupyter website as a citeable "Jupyter paper"
• Choose a source-of-truth for where Jupyter's citable papers go
• Choose a source-of-truth for documenting the guidelines around citations for Jupyter papers
• Document this in the governance docs, docs.jupyter.org, and jupyter.org
• Notify all of the subprojects of this policy and encourage them to link to our docs.

References

• JupyterLab version of this issue: How to cite JupyterLab jupyterlab/frontends-team-compass#144

Known papers in the jupyter ecosystem that might be relevant here

• Kluyver et al, notebook paper
• Jupyter et al, Binder 2.0

Relevant discussions and references for citations in other projects

• NumPy citations
• SageMath citations

[choldgraf]

+1 I agree - there should be a location where all of the jupyter-based publications are listed and which pieces of tech they refer to.

[sunnyjain15699]

I will add it. I will need some guidelines though. Can I get this ticket ?

[SauravBhowmick]

I will add it. I will need some guidelines though. Can I get this ticket ?

Can i also work in this issue? @palewire ?

[choldgraf]

Many thanks for offering to pick this one up. That said, I don't think that this is the best issue to take up for new contributors. There isn't an obvious place where this information would go, and we also don't have a source of truth for what is "a jupyter paper". My feeling is that implementing this might require more community discussion or knowledge of the plan for the website, or it might become quite complex to work on right now. If somebody else is around to get this in, that might work, but at least I don't have a lot of bandwidth to shepherd this one in at the moment.

[SauravBhowmick]

It's tagged in good first issue so I thought to pick it up. Anyways, any good beginner friendly issues that you might suggest here?

[choldgraf]

Let me clean up the issue a bit and then see how complex it looks as a result. I'm not sure who tagged it as a good first issue, so if others disagree then I'm happy to hear so!

To me the big challenge is that there is no 'jupyter paper', and the one mentioned in this issue is more like "the only paper that is citable and about the notebook" but it also doesn't quite follow the authorship guidelines because it was written before those guidelines existed.

As a result it feels like a more complex decision to promote that paper as "the paper to vote jupyter" given that it cuts against our own policy. That's why I'm not sure what to do about this and think it is more complex than just throwing up the link...

[krassowski]

Linking a related discussion about citing JupyterLab: jupyterlab/frontends-team-compass#144.