Add words about citation to affiliated package review

[kelle]

Adds one sentence to the Documentation section of the Affiliated Package review process. (I will also open an PR on the website to provide a link to some resources.)

[kelle]

Issues opened to request those coordinated packages add a CITATION file. EDIT: Links in Pey Lian's comment below.

[pllim]

I cannot edit your post above, but this is an easier way to cross-ref issues across GitHub (also, the third URL was wrong):

• Add CITATION file astropy-healpix#167
• Add CITATION file regions#409
• Add CITATION file reproject#262

[dhomeier]

Re: guidelines on actually how to cite, we certainly should not set any strict rules, but some hints on what could get inside the CITATION.x file could perhaps be useful.
E.g.

This can consist of simply providing a Zenodo link if the package has an entry (highly recommended), or the bibliography of papers describing it. Full BibTeX entries will be useful for many users publishing results based on your package.

Needs of course some good balance of minimal info and making too lengthy prescriptions; also wondering if the details are better put into the guidelines (unless both are to be kept closely sync'ed).
And those hints are certainly included in extensive detail in the Astrobetter link, but the two – Zenodo + BibTeX – were just the most obvious ones when looking at the present examples.

[kelle]

I added more words to the website. Check out astropy/astropy.github.com#460

[dhomeier]

Good to go once astropy/astropy.github.com#460 is done!

[dhomeier]

Should we merge this as well to keep in sync with astropy/astropy.github.com#460?
The latter is the more visible one to (potential) affiliated package maintainers anyway.

[kelle]

I vote yes but am not sure of who should push the button. @pllim ?

[pllim]

Sure, though I see healpix and reproject are still lagging. I cannot merge here.

[kelle]

I am happy with the discussion having started in both places. Merging.