|
1 | 1 | --- |
2 | 2 | title: Citation File Format Hack Day @ RSE18 |
| 3 | +toc: true |
3 | 4 | --- |
4 | 5 |
|
| 6 | +{% include toc %} |
| 7 | + |
5 | 8 | The [Citation File Format (CFF)](https://citation-file-format.github.io/) is a human-centric, machine-readable format for software citation metadata. It is developed to provide an easy way for RSEs, and other developers of software in academia, to ensure that they can receive credit for their work; Likewise, it provides researchers with access to the necessary metadata for references to the software they use in their research. The Citation File Format follows the [Software Citation Principles](https://peerj.com/articles/cs-86/), and is compatible with the [CodeMeta](http://codemeta.github.io/) JSON-LD exchange format for software metadata. It is being developed in the context of the [FORCE11 Software Citation Implementation Working Group](https://www.force11.org/group/software-citation-implementation-working-group) and a wider community of stakeholders, including the [Netherlands eScience Center](https://www.esciencecenter.nl/). Recently, CFF has been adopted by [CiteAs.org](http://citeas.org/) as a source format, and its tools infrastructure is growing. |
6 | 9 |
|
7 | | -During a dedicated **Hack Day on Wednesday, 5 September** - co-locating with the [3rd Conference of Research Software Engineers (RSE18)](http://rse.ac.uk/conf2018/) in Birmingham - we want to *a)* give an overview of - and discuss - the Citation File Format, its tooling and workflows; *b)* discuss what tools would be necessary to facilitate, e.g., better usability, optimized workflows, or integration with other tools in the software citation workflow (reference managers, repositories, other formats, etc.); *c)* do some actual work around existing and new tools, as well as the Citation File Format itself and its documentation. |
| 10 | +## Hack Day at the 3rd Conference of Research Software Engineers |
8 | 11 |
|
9 | | -**Participation is free and open to everyone**, regardless of their skill set and experience. |
| 12 | +During a dedicated **Hack Day on Wednesday, 5 September** - co-locating with the [3rd Conference of Research Software Engineers (RSE18)](http://rse.ac.uk/conf2018/) in Birmingham - we want to |
10 | 13 |
|
11 | | -**Registration** has been possible through the [registration form for #RSE18](https://store.southampton.ac.uk/conferences-and-events/physical-sciences-and-engineering/physics-astronomy/events/third-conference-of-research-software-engineers). If you don't attend the main |
12 | | -conference but want to participate in the hack day, please let me know per email at |
13 | | -*stephan* [dot] *druskat* [at] *hu-berlin* [dot] *de*. |
| 14 | +- *a)* give an overview of - and discuss - the Citation File Format, its tooling and workflows; |
| 15 | +- *b)* discuss what tools would be necessary to facilitate, e.g., better usability, optimized workflows, or integration with other tools in the software citation workflow (reference managers, repositories, other formats, etc.); |
| 16 | +- *c)* do some actual work around existing and new tools, as well as the Citation File Format itself and its documentation. |
14 | 17 |
|
15 | | -**PLEASE NOTE THAT THE HACK DAY IS NOW FULLY BOOKED!** |
16 | | -If you have confirmed your attendance per email, you're on board. |
17 | | -If you have registered, but have not yet confirmed your attendance per email, |
18 | | -you can still do so and will be added to the waiting list for the event. |
| 18 | +**The hack day is now fully booked!** If you have re-confirmed your participation |
| 19 | +via email to Stephan Druskat, you will have received a confirmation email and preliminary infos |
| 20 | +about the hack day, and have a place. |
| 21 | +Please confirm your wish to participate via email to *stephan* [dot] *druskat* |
| 22 | +[at] *hu-berlin* [dot] *de* to be added to the waiting list. If space becomes available for you, |
| 23 | +you will be notified via email. |
| 24 | +{: .notice--danger} |
19 | 25 |
|
20 | | -**Participation is limited to 30 attendees**, and participants will be |
21 | | -selected on a first come first serve basis. You will be notified about your participation per |
22 | | -email at the beginning of August (i.e., once registration is closed) at the latest. |
23 | | -Please also consider this with regard to booking your accommodation and travel. |
| 26 | +## Location |
24 | 27 |
|
25 | | -**Accommodation** for participants is available at Chamberlain Halls and can be booked through the |
26 | | -main [accommodation booking form](https://rse.ac.uk/conf2018/accommodation/). Note that |
27 | | -accommodation for Wednesday night (5 September) is also available through this form for |
28 | | -participants who do not travel after the end of the hack day on Wednesday. |
| 28 | +The hack day will take place in the **Murray Learning Centre**, R28, |
| 29 | +University of Birmingham, Birmingham B15 2FG |
| 30 | +([Google Maps](https://goo.gl/maps/UDPocWznNW52), [Walking Map](walking-map.pdf): marked as "Learning Centre" on p.2 |
| 31 | +below the legend), room tbc. |
29 | 32 |
|
30 | | -Please **get in touch** with any questions and comments via email to |
31 | | -*stephan* [dot] *druskat* [at] *hu-berlin* [dot] *de*. |
| 33 | +The international morning |
| 34 | +meeting and the Tier-2/HPC workshop will also take place there, so that |
| 35 | +you can meet delegates from the other events during lunch and coffee breaks. |
| 36 | + |
| 37 | +### Pre-Hack Day Social |
| 38 | +On the evening before the hack day, if you want to get to know your fellow |
| 39 | +hackers in advance, there will be an **informal get-together**, and you're invited |
| 40 | +to come along for a drink and a chat. We'll meet at the [Arco Lounge](https://thelounges.co.uk/arco/) |
| 41 | +(147 High Street, Harborne, Birmingham, B17 9NP - [Google Maps](https://goo.gl/maps/YkDAuqYszWF2)) |
| 42 | +from around 18:00 on Tuesday, 4 September. They have food as well (including quite a few vegan options). |
| 43 | + |
| 44 | +## Agenda |
| 45 | + |
| 46 | +### Tuesday, 4 September 2018 |
| 47 | + |
| 48 | +**RSE Talk:** Tuesday, 4 September 2018, [13:30, parallel session 4, Track B](https://rse.ac.uk/conf2018/programme/) - |
| 49 | +S. Druskat: *"YOU HAVE 0 CREDIT – PLEASE INSERT C̶O̶I̶N̶ FILE": The Citation File Format* |
| 50 | + |
| 51 | +**Pre-Hack Day Social:** Tuesday, 4 September 2018, from ca. 18:00, [Arco Lounge](https://thelounges.co.uk/arco/) |
| 52 | +{: .btn--break .btn--info} |
| 53 | + |
| 54 | +<i class="fa fa-fw fa-twitter" aria-hidden="true"></i> If you want to tweet about the hack day, please use the hashtag **#cffhackday**. |
| 55 | +{: .notice--info} |
| 56 | + |
| 57 | +### Wednesday, 5 September 2018, 09:00 - 17:00 |
| 58 | + |
| 59 | +**09:00** - *Registration: Coffee and Tea* |
| 60 | +{: .btn--break .btn--info} |
| 61 | + |
| 62 | +**09:15** - Introductions |
| 63 | +**09:30** - **Talk:** "Brief introduction to the Citation File Format" (S. Druskat) |
| 64 | +**09:50** - **Talk:** "The Citation File Format at the Netherlands eScience Center" (J. Spaaks) |
| 65 | +**10:15** - **Hack idea pitches & group formation** (<http://bit.ly/cff-hack-ideas>) |
| 66 | +{: .btn--break .btn--warning} |
| 67 | + |
| 68 | +**10:45** - *Coffee and Tea break* |
| 69 | +{: .btn--break .btn--info} |
| 70 | + |
| 71 | +<br/>**11:00** - **Hacking in groups**<br/><br/> |
| 72 | +{: .btn--break .btn--success} |
| 73 | + |
| 74 | +**12:00** - *Lunch* |
| 75 | +{: .btn--break .btn--info} |
32 | 76 |
|
33 | | -## Dates & agenda |
| 77 | +**12:30** - **Hacking updates** (plenary) |
| 78 | +{: .btn--break .btn--warning} |
34 | 79 |
|
35 | | -- **Hack day**: Wednesday 5 September 2018, 9:00-17:00 |
36 | | -- **Venue**: University of Birmingham, exact location tba |
37 | | -- **Agenda**: tba |
| 80 | +<br/>**12:45** - **Hacking in groups**<br/><br/> |
| 81 | +{: .btn--break .btn--success} |
| 82 | + |
| 83 | +**14:30** - *Coffee and Tea break* |
| 84 | +{: .btn--break .btn--info} |
| 85 | + |
| 86 | +<br/>**14:45** - **Hacking in groups**<br/><br/> |
| 87 | +{: .btn--break .btn--success} |
| 88 | + |
| 89 | +**16:00** - **Hacking reports & Wrap-up** |
| 90 | +{: .btn--break .btn--warning} |
| 91 | + |
| 92 | +**17:00** - *End* |
| 93 | +{: .btn--break .btn--info} |
| 94 | + |
| 95 | +## Hack ideas |
| 96 | + |
| 97 | +If you have an idea how the Citation File Format, its tooling, its |
| 98 | +documentation, or its integration in the software citation workflow could be |
| 99 | +improved, you **please register your hack idea** in the |
| 100 | +Hack Ideas Spreadsheet at <http://bit.ly/cff-hack-ideas>. |
| 101 | +If you register a hack idea, please be prepared to present a very short |
| 102 | +pitch of the idea during the hack day. |
| 103 | + |
| 104 | + |
| 105 | +## Code of Conduct |
| 106 | + |
| 107 | +I want to make sure that the hack day is welcoming and friendly to everyone. |
| 108 | +Therefore, **please read Code of Conduct. You are expected to adhere to it.** |
| 109 | +It can be read here: <https://citation-file-format.github.io/events/coc>. |
| 110 | + |
| 111 | +## Resources |
| 112 | + |
| 113 | +- The main resource for the Citation File Format itself is the [**project |
| 114 | +website**](https://citation-file-format.github.io). Some basic info can |
| 115 | +also be found at <https://cite.research-software.org>. |
| 116 | +- <i class="fa fa-fw fa-slack" aria-hidden="true"></i> **Slack channel:** I've set up a Slack channel for the hack day. Please join it, |
| 117 | +using this link: <http://bit.ly/cff-hack-day-slack-invite>! If you haven't used Slack |
| 118 | +before, some info on getting started can be found at <https://get.slack.help/hc/en-us/categories/360000049043> |
| 119 | +- <i class="fa fa-fw fa-github" aria-hidden="true"></i> **GitHub:** The suggested code platform to use for any hacktivities |
| 120 | +during the hack day. Please create an account on GitHub if you haven't |
| 121 | +got one yet. Some info to get you started can be found at <https://guides.github.com/activities/hello-world/>. |
| 122 | +- <i class="fa fa-fw fa-twitter" aria-hidden="true"></i> If you want to tweet about the hack day, please use the hashtag **#cffhackday**. |
| 123 | + |
| 124 | +## Contact |
| 125 | + |
| 126 | +Please **get in touch** with any questions and comments via email to |
| 127 | +*stephan* [dot] *druskat* [at] *hu-berlin* [dot] *de*. |
38 | 128 |
|
39 | 129 | --- |
40 | 130 |
|
| 131 | +## Thanks |
| 132 | + |
41 | 133 | I'd like to thank the following for their great help and support in organizing this hack day: |
42 | 134 |
|
43 | 135 | - [#RSE18 organizing committee](https://rse.ac.uk/conf2018/contacts/), especially Louise Brown, |
|
0 commit comments