{"action":"created","issue":{"url":"https://api.github.com/repos/uclibs/scholar_uc/issues/628","repository_url":"https://api.github.com/repos/uclibs/scholar_uc","labels_url":"https://api.github.com/repos/uclibs/scholar_uc/issues/628/labels{/name}","comments_url":"https://api.github.com/repos/uclibs/scholar_uc/issues/628/comments","events_url":"https://api.github.com/repos/uclibs/scholar_uc/issues/628/events","html_url":"https://github.com/uclibs/scholar_uc/issues/628","id":134088284,"number":628,"title":"New Help Page: Documenting Data","user":{"login":"ntallman","id":549591,"avatar_url":"https://avatars.githubusercontent.com/u/549591?v=3","gravatar_id":"","url":"https://api.github.com/users/ntallman","html_url":"https://github.com/ntallman","followers_url":"https://api.github.com/users/ntallman/followers","following_url":"https://api.github.com/users/ntallman/following{/other_user}","gists_url":"https://api.github.com/users/ntallman/gists{/gist_id}","starred_url":"https://api.github.com/users/ntallman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ntallman/subscriptions","organizations_url":"https://api.github.com/users/ntallman/orgs","repos_url":"https://api.github.com/users/ntallman/repos","events_url":"https://api.github.com/users/ntallman/events{/privacy}","received_events_url":"https://api.github.com/users/ntallman/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/uclibs/scholar_uc/labels/2%20-%20Working","name":"2 - Working","color":"CCCCCC"},{"url":"https://api.github.com/repos/uclibs/scholar_uc/labels/in%20progress","name":"in progress","color":"ededed"},{"url":"https://api.github.com/repos/uclibs/scholar_uc/labels/UX%20improvements","name":"UX improvements","color":"5319e7"}],"state":"open","locked":false,"assignee":{"login":"13miciunasl","id":9759017,"avatar_url":"https://avatars.githubusercontent.com/u/9759017?v=3","gravatar_id":"","url":"https://api.github.com/users/13miciunasl","html_url":"https://github.com/13miciunasl","followers_url":"https://api.github.com/users/13miciunasl/followers","following_url":"https://api.github.com/users/13miciunasl/following{/other_user}","gists_url":"https://api.github.com/users/13miciunasl/gists{/gist_id}","starred_url":"https://api.github.com/users/13miciunasl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/13miciunasl/subscriptions","organizations_url":"https://api.github.com/users/13miciunasl/orgs","repos_url":"https://api.github.com/users/13miciunasl/repos","events_url":"https://api.github.com/users/13miciunasl/events{/privacy}","received_events_url":"https://api.github.com/users/13miciunasl/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/uclibs/scholar_uc/milestones/41","html_url":"https://github.com/uclibs/scholar_uc/milestones/Sprint%20Ending%204/15/2016","labels_url":"https://api.github.com/repos/uclibs/scholar_uc/milestones/41/labels","id":1676092,"number":41,"title":"Sprint Ending 4/15/2016","description":"","creator":{"login":"scherztc","id":5084562,"avatar_url":"https://avatars.githubusercontent.com/u/5084562?v=3","gravatar_id":"","url":"https://api.github.com/users/scherztc","html_url":"https://github.com/scherztc","followers_url":"https://api.github.com/users/scherztc/followers","following_url":"https://api.github.com/users/scherztc/following{/other_user}","gists_url":"https://api.github.com/users/scherztc/gists{/gist_id}","starred_url":"https://api.github.com/users/scherztc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/scherztc/subscriptions","organizations_url":"https://api.github.com/users/scherztc/orgs","repos_url":"https://api.github.com/users/scherztc/repos","events_url":"https://api.github.com/users/scherztc/events{/privacy}","received_events_url":"https://api.github.com/users/scherztc/received_events","type":"User","site_admin":false},"open_issues":34,"closed_issues":2,"state":"open","created_at":"2016-03-31T13:54:31Z","updated_at":"2016-04-04T16:34:35Z","due_on":"2016-04-15T04:00:00Z","closed_at":null},"comments":6,"created_at":"2016-02-16T20:26:22Z","updated_at":"2016-04-04T19:01:08Z","closed_at":null,"body":"Per the Digital Content Working Group.\r\n\r\nPage Title: Documenting Data\r\nPage Location: Insert, alphabetically, into Help menu\r\n\r\nPlease also add the following [bootstrap warning alert](http://getbootstrap.com/2.3.2/components.html#alerts) to the Dataset work-type input form: \"Please read the [Documenting Data](#) help page before submitting a dataset to Scholar@UC.\"\r\n\r\n--------------------------------------------------\r\n\r\n# Documenting Data\r\n\r\n<blockquote>&ldquo;Data without context are inert, but data within contexts become information, knowledge.&rdquo;<br/> \r\nFrom: Changing the Subject: Art and Attention in the Internet Age By Sven Birkerts</blockquote>\r\n\r\nProper documentation provides the context that your data needs to persist through time, to integrate into new systems and to give you credit for your contributions in the form of data citations.  Where possible, you should contribute the following information along with your dataset:\r\n\r\n1. **Complete Metadata** – Metadata aids Discovery and Reuse.  Scholar@UC requires metadata such as title of work, creator name, data submitted and description.  All text is searchable.  You should write a detailed description to increase discoverability of your content.  Also provided are additional metadata fields under the Show Additional Description link.  Here you can add in additional fields such as subject terms for search enhancement.  If you are following a suggested schema for your discipline, indicate that in the description or in the next document – the README file.\r\n\r\n2. **README.txt File** – This is a text document that provides relevant information such as purpose of the project and the organizational structure or relationship of the files.  It explains terms that are unique to the dataset, keywords, omissions and errors.  If you are using a file naming convention, you can explain it in the readme file.  It is also the place to put additional details that were not included in the metadata, such as additional information about external storage of the data, metadata schema followed and researcher contact information.\r\n\r\n\ta. A good example can be found in the [Data ab Initio blog post README.txt by Kristin Briney](http://dataabinitio.com/?p=378) \r\n\r\n3. **Data Dictionary/Codebook** – This document explains all the variables and abbreviations associated with the dataset. \r\n\r\n\ta. Links below to data dictionaries from The University of Texas at Austin’s Population Research Center ([data dictionary examples](http://www.utexas.edu/cola/redcap/Project-Examples.php)) and IRSA ([data dictionary example](http://irsa.ipac.caltech.edu/applications/DDGEN/Doc/dd_tbl.html)) provide two quick examples of data dictionaries.  \r\n\r\n4. **Methodology/Protocol** – This document details the steps taken to collect the data.  If you submitted modified data instead of a raw data set, you can explain those steps in this document.  \r\n\r\n### Additional Resources on Documentation for Data:\r\n\r\n1. [ICPSR's Guide to Social Science Data Preparation and Archiving](http://www.icpsr.umich.edu/icpsrweb/content/deposit/guide/index.html)\r\n2. [DataOne Best Practices](https://www.dataone.org/best-practices) \r\n3. [Mantra Research Data Management Training](http://datalib.edina.ac.uk/mantra/) \r\n4. [DataDryad FAQ](http://datadryad.org/pages/faq)\r\n5. [Digital Curation Centre How-to Guides & Checklists](http://www.dcc.ac.uk/resources/how-guides) \r\n\r\n\r\n<!---\r\n@huboard:{\"milestone_order\":628.0,\"order\":109.63671875,\"custom_state\":\"\"}\n-->\r\n"},"comment":{"url":"https://api.github.com/repos/uclibs/scholar_uc/issues/comments/205449052","html_url":"https://github.com/uclibs/scholar_uc/issues/628#issuecomment-205449052","issue_url":"https://api.github.com/repos/uclibs/scholar_uc/issues/628","id":205449052,"user":{"login":"13miciunasl","id":9759017,"avatar_url":"https://avatars.githubusercontent.com/u/9759017?v=3","gravatar_id":"","url":"https://api.github.com/users/13miciunasl","html_url":"https://github.com/13miciunasl","followers_url":"https://api.github.com/users/13miciunasl/followers","following_url":"https://api.github.com/users/13miciunasl/following{/other_user}","gists_url":"https://api.github.com/users/13miciunasl/gists{/gist_id}","starred_url":"https://api.github.com/users/13miciunasl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/13miciunasl/subscriptions","organizations_url":"https://api.github.com/users/13miciunasl/orgs","repos_url":"https://api.github.com/users/13miciunasl/repos","events_url":"https://api.github.com/users/13miciunasl/events{/privacy}","received_events_url":"https://api.github.com/users/13miciunasl/received_events","type":"User","site_admin":false},"created_at":"2016-04-04T19:01:08Z","updated_at":"2016-04-04T19:01:08Z","body":"Here are the first options that I spun up for the page design. Let me know how you feel about them (anyone)\r\n\r\n![screen shot 2016-04-04 at 2 51 40 pm](https://cloud.githubusercontent.com/assets/9759017/14259670/ea36164e-fa75-11e5-90d2-061634414005.png)\r\n![screen shot 2016-04-04 at 2 54 20 pm](https://cloud.githubusercontent.com/assets/9759017/14259672/ea3742e4-fa75-11e5-99fa-bb81ed903239.png)\r\n![screen shot 2016-04-04 at 2 57 48 pm](https://cloud.githubusercontent.com/assets/9759017/14259671/ea36e1d2-fa75-11e5-8349-27726811ebba.png)\r\n![screen shot 2016-04-04 at 2 58 05 pm](https://cloud.githubusercontent.com/assets/9759017/14259673/ea38687c-fa75-11e5-951d-59a64c1f1e13.png)\r\n"}}