CommunityData:Meetup July 2017/Infrastructure

From CommunityData

Outline

Zotero

Checkoff list before we start:

  • Everybody upgrade to Zotero 5.0. You will need to download this from https://www.zotero.org because it was released recently and its not in the distributions yet. It's important to be running the new version. This will break support for BetterBibLaTeX but is also fixes most of the bugs that required this in the first place.
  • Everybody make sure you have joined and a member of the Community Data Science Collective Zotero repository.

Things that everybody should know:

  • In Zotero, folders are not like traditional folders. They are like tags. Do not add things if they are already there!
  • Holding down ALT is extremely useful! It will show you which folders the selected item is in!

The process to add something cleanly is complicated but should always include the following steps:

  1. Check to see if it's in the CDSC shared folder by clicking on the top level of the shared group and searching. If it is already there, just drag it into your new subfolder for your project. If it's not, click back on your sub-folder and add it.
  2. Once you've added, change the title to sentence case. You can do this by: (a) Right clicking on title → Transform Text → Sentence Case (b) you will then need to capitalize any proper nouns (e.g., Scratch, Wikipedia) as well as anything immediately following a ":". This is important because software like BibTeX/BibLaTeX can change from "Sentence case" to "Title Case" automatically, but not the other way around. APA 6 requires sentence case.
  3. Ensure that there's a DOI for your entry if it's necessary. Some publishers and conferences (like AAAI publications which publishes ICWSM) do not have DOIs. If your publication does not a DOI, it needs to have a URL because APA 6 requires one or the other.
  4. Standardize the publisher names. According to APA 6 drop common words like "Press," "Publisher," "Inc." as well as first names (i.e., just Wiley, not John Wiley Inc.)
  5. Standardize the place names. APA 6 requires "City, State" within the USA and "City, Country" outside. So, it's "New York, New York" for the ACM and "Cambridge, UK" for University of Cambridge Press.
  6. Remove anything in the "Extra" field unless it's something you want to be printed every time. Sometimes things like "ⓒ JSTOR" sneaks in.
  7. Make sure that there's a PDF attached and then rename the PDF by: Right click on PDF → Rename File from Parent Metadata

Ideas of things to cover in an infrastructure and hygiene session

  • gitolite
  • mailing list
  • IRC
  • Zotero(!!)
  • Migration away from the wikiresearch hosting on Github
  • Planning documents (creating a shared repository?)
  • Wiki organization
  • Move RCommunityData to it's own git repository