search

carpentries / lesson-example

Example lesson using The Carpentries lesson template.
https://carpentries.github.io/lesson-example/
Other
64 stars 173 forks source link

Citations #110

Open odonlife opened 7 years ago

odonlife commented 7 years ago

This is a comment for just about every lesson in the carpentry course and comes from a librarian, but where are the citations?

Ex:. The Bourne Again SHell reference could be cited with C Programming by Al Stevens, Dr. Dobb's Journal, July 1, 2001

"The Mother of All Demos" could be cited as B. (2007, August 05). Douglas Engelbart : The Mother of All Demos (2/9). Retrieved from https://www.youtube.com/watch?v=a11JDLBXtPQ

Especially since we are placing a CCL on this content it is important that copyrighted content is properly identified.

rgaiacs commented 7 years ago

@odonlife Thanks very much for the suggestions.

but where are the citations?

I really like citations but if I'm dealing with online documents I'm OK if people use links to give credit to others instead of "traditional" citation. I know that librarians hate links because the resource they point to could be unavailable tomorrow, I hate links for the same reason, but I will be -1 to use "traditional" citations for two reasons. My first reason is that write citation could be very painful if you are doing it manually and I don't know any good tool to manage citations when using Markdown files. Maybe @odonlife, @drjwbaker, @weaverbel or someone else knows a great tool that is open source and works with Windows, macOS and Linux. My second reason is that HTML has a <cite> element that can only be represented in Markdown by using HTML but in the past we voted to avoid HTML at our Markdown files.

drjwbaker commented 7 years ago

I use Zotero to manage citations https://www.zotero.org/ It is free, open-source, cross-platform and let's you export bibliographies and citations in a range of formats and in whatever citation style you need.

I'd say SWC should have citations. Citations are central to intellectual honesty and ensure that all outputs - papers, reports, data, software - gets the credit they deserve.

gvwilson commented 7 years ago

I'd say SWC should have citations. Citations are central to intellectual honesty and ensure that all outputs - papers, reports, data, software - gets the credit they deserve. +1