Earlier this month, we published our lessons by giving them DOIs through Zenodo. As we said in an earlier post, though, we've been struggling to figure out (a) how to cite them in text and (b) how to express their metadata in standard bibliographic formats to produce those human-readable citations.
Gabriel Devenyi and Christina Koch (eds), 63 authors including Noam Ross: "Software Carpentry: The Unix Shell" Software Carpentry Foundation, Version 5.3, May 2015, 10.5281/zenodo.27355.
I like this a lot: it includes the canonical form (editors, title, date, DOI) and avoids the issues associated with appearing to ascribe collaborations to whichever contributor's surname is lexically first. What we still don't know, though, is how to create entries in standard bibliographic formats like BibTeX so that they will produce this text when rendered. As distributed collaborations mediated by tools like GitHub become more common, that's a problem we're going to have to solve.