[WIP] Stubbing out docs for paper preparation

[arfon]

I'd like to write some better documentation to help authors preparing JOSS papers. For most authors this is a pretty straightforward process, but when it goes wrong, or authors have more specialist needs for their papers, we don't have very good documentation to support them.

I'd be interested to hear from @openjournals/joss-editors what they think we should try and capture here based on their experiences.

/ cc #553

[brainstorm]

Good points @arfon! I guess that alongside the docs, an insanely complete example that authors can just delete sections off of would help a lot, i.e:

https://gist.github.com/marktheunissen/2979474

... since in this day and age, fewer and fewer people actually read docs, unfortunately ;)

[arfon]

https://gist.github.com/marktheunissen/2979474

Yeah, that's a great idea. We could easily update the example paper to be a 'feature complete' one like you suggest.

[mbobra]

Also (perhaps for a separate PR) it would be nice to include some information about joint submissions between an AAS journal and JOSS. The JOSS blog post announcing this partnership says:

Any submission to JOSS that has come via AAS will be clearly marked as such in the review process. We’ll create some additional documentation on https://joss.readthedocs.io explaining what’s going on.

[arfon]

Also (perhaps for a separate PR) it would be nice to include some information about joint submissions between an AAS journal and JOSS. The JOSS blog post announcing this partnership says:

👍 great idea.

[pedramardakani]

Hey there @arfon 👋 I saw your pull request after creating my own on adding a TiKZ example to the demo paper.md file 🤓 This is a nice pull request, good work 👍