# Book Dash, 17 November 2023 - Day 5 *tags: bookdash 2023 Nov event* -- * Link of Links: [https://ttw-book-dash-nov23.start.page/]([]https://ttw-book-dash-nov23.start.page/[]) * Date: 17 Nov 2023 * Location: London Hub (The Turing Institute) and Online ## 💻 Zoom link * Zoom: [https://turing-uk.zoom.us/j/95440762504?pwd=ZmJBKzdMR0ZqMktVanVtam9VQ2ZtZz09\&from=addon]([]https://turing-uk.zoom.us/j/95440762504?pwd=ZmJBKzdMR0ZqMktVanVtam9VQ2ZtZz09\&from=addon[]) * Meeting ID: 954 4076 2504 * Passcode: 844698 ## Relevant links to keep handy * Link of links: * [https://ttw-book-dash-nov23.start.page/]([]https://ttw-book-dash-nov23.start.page/[]) * *Note that in the weeks prior to the book dash this main link has had various iterations. This should be the correct one to save/bookmark!* * Calendar * Overview timetable as a Google doc spreadsheet: [https://docs.google.com/spreadsheets/d/1n4AD\_B-UGFYvtNbS1\_rsPmOeXY75IBSI0ApuY0vDRRE/edit?usp=sharing](https://docs.google.com/spreadsheets/d/1n4AD\_B-UGFYvtNbS1\_rsPmOeXY75IBSI0ApuY0vDRRE/edit?usp=sharing) ### Quick reminders * *The Turing Way* participation guidelines apply to this event: * Code of Conduct: [https://the-turing-way.netlify.app/community-handbook/coc.html](https://the-turing-way.netlify.app/community-handbook/coc.html) * Contribution guideline: [https://github.com/alan-turing-institute/the-turing-way/blob/master/CONTRIBUTING.md](https://github.com/alan-turing-institute/the-turing-way/blob/master/CONTRIBUTING.md) * Time is provided in London Time (UTC+1). Please use this link to convert in your time zone: convert time: [https://arewemeetingyet.com/london/2021-05-20/11:00](https://arewemeetingyet.com/london/2021-05-20/11:00) ## Day 5: 17 Nov 2023 * Today we will host two *Community Share-out and Contributor Celebration* sessions from * 11:00 - 12:00 * and * 17:00 - 18:00. * In between these two share-outs, we will host a working group share-outs between 14:00 - 15:00. * The community share-out sessions will be recorded - please feel free to turn off your camera if you don’t wish to be in the recording * Community Share-outs: [https://annuel2.framapad.org/p/ttw-bookdash-nov2023-feedback](https://annuel2.framapad.org/p/ttw-bookdash-nov2023-feedback) * Working Group Share-outs: [https://www.eventbrite.co.uk/e/the-turing-way-working-group-and-collaborator-celebrations-nov-2023-tickets-744294955247?aff=oddtdtcreator](https://www.eventbrite.co.uk/e/the-turing-way-working-group-and-collaborator-celebrations-nov-2023-tickets-744294955247?aff=oddtdtcreator) *Name / Organisation or project / What you are hoping to learn about at today’s Community Share out?* (For folks attending the working group sessions: What are you hoping to learn about ) * David Llewellyn-Jones / The Alan Turing Institute / All of the amazing things that have been added to or changed, or that are in flight towards, The Turing Way book. * Fran Gómez / The Alan Turing Institute / Hearing what exciting things everyone's been working towards this week! * Kirstie Whitaker / The Alan Turing Institute / Celebrating the diversity of the contributions - I'm particularly interested in the ways of working, project management, and inclusion / accessibility related updates to the book! :sparkles: * Alexandra Araujo Alvarez / Alan Turing Institute / celebrating the collective work of Book Dash attendees * Batool Almarzouq/ Alan Turing Institute * Sophie Arana / Alan Turing Institute / curious to hear about what people have been working on, big Fomo on my part :) * Sarah Gibson / 2i2c * Susana (she her)/ what other people have been doing of course!! * Jen Ding / The Alan Turing Institute / Reviewing all that's happened this week! * Cass Gould van Praag / Alan Turing Institute / What the communnity are excited about and interested in! * Sophia Batchelor / The Alan Turing Institute / Hearing about everything that's being done across the week * Jim Madge / The Alan Turing Institute / To see all of the great things that have happened at book dash! * Anne Lee Steele / Alan Turing Institute / All the amazing updates from folks! * Alejandro Coca-Castro / The Alan Turing Institute / celebrating the amazing contributions from TTW folks * Richard J. Acton / HDBI / * Alden Conner / The Alan Turing Institute / learning about all the wonderful book dash work and the working groups! * Vicky Hellon / The Turing Institute/ getting updates on all the amazing work! * María Nanton / Metadocencia / learning the outcomes of a great Book Dash! * Esther Plomp / TU Delft / Getting all the updates! * Jesica Formoso / Metadocencia / Hearing about the updates ### Agenda Part 1: * Community Update: Shout outs - 10 mins * This session will be recorded * Visual * What have we done over the last week, what to come next! Part 2: * Report outs: 3 mins each person - 30/40 mins * Introduce yourself * Introduce your topic that you worked on * Demo by sharing screen what you have been collaborating on * Show illustration (if possible integrate that in your text) that you contributed to - for the second session * Close by asking how people can collaborate Closing * Questions \& Answers for all speakers * Open Q\&A and Feedback * wrap up Chairs: Session 1: Anne Session 2: Anne ### Welcome! Useful links for The Turing Way: * More about The Turing Way: [https://the-turing-way.start.page/](https://the-turing-way.start.page/) * Learn more about The Turing Way Team (Core Volunteer Members, Translation and Localisation leads, Staff members): [https://github.com/alan-turing-institute/the-turing-way/blob/main/ways\_of\_working.md](https://github.com/alan-turing-institute/the-turing-way/blob/main/ways\_of\_working.md) ### Community Share-out Sessions: Demo/goals/plans/ideas: 2-3 mins each team * Name: Susana and Ceilidh * Links to Issues and PR: * (DONE) Adding an image to the book: [https://github.com/the-turing-way/the-turing-way/pull/3377](https://github.com/the-turing-way/the-turing-way/pull/3377) * ASK: checked by Kalle, Emma and Arielle and implemented in book! * Links to Issues and PR: (later in the day) * Adding an image to the book: [https://github.com/the-turing-way/the-turing-way/pull/3435](https://github.com/the-turing-way/the-turing-way/pull/3435) * ASK: saying deploy error, not sure how to fix. * * Chapter is ready and we will do PR some point today!! * Notes: * Susana and Ceilidh were Enrichment student and offered a symposium on the topic last year and wanted to add these learning from this sessions. * Case study example about how to apply the data hazards * They have submitted their PR for their chapter * It has been FUN working together, hang around and being in the office. Spoiler alert: photos will be shared of the experience of working together. It's been really nice to be back in The Turing. * Thanks to all people that helped them. * Questions from the group: what is the co-writing process like? Fun, says Susana. Ceilidh and Susana work together and separately, learning to combine the different energies they bring. * What is your Derby name, for Ceilidh: Grumplestiltskin (#33) * Name: Jen * Links to Issues and PR: * This chapter is live now! [https://the-turing-way.netlify.app/project-design/data-governance/bigcode\_casestudy](https://the-turing-way.netlify.app/project-design/data-governance/bigcode\_casestudy) (Thanks to Kalle, Esther, and Anne!) * [https://github.com/the-turing-way/the-turing-way/issues/3411](https://github.com/the-turing-way/the-turing-way/issues/3411) * ASK: A future review after this draft case study is further along... * Notes: * Learn a lot about bullet point syntax with Kalle and impressed with the addition to the Style guide * Case study on Open Source AI Initiatives, check the work or Aya. No ask at the moment but will keep the issue open * Questions form the group: * Cass: Tell us more about the bullet point syntax drama! I'll review the [style guide]([https://the-turing-way.netlify.app/community-handbook/style)](https://the-turing-way.netlify.app/community-handbook/style))! * Oh man... bullets... subbullets and indents or spaces has always been my nightmare. Kalle real-time tested some different variations to confirm once and for all that spaces before a bullet don't make a difference! See this thread to make ^ this incoherent rambling clearer: [https://theturingway.slack.com/archives/C0609CQKMRD/p1699954618140599](https://theturingway.slack.com/archives/C0609CQKMRD/p1699954618140599) * Collaboration process perspective: how did you coordinate that? More logistically complex as we need to bring more people into our platform. How can we bring more people to collaborate and bring their own material - Fireside chat is good place to start * Name: Fran Gómez * Links to Issues and PR: * Subchapter to industry-academia collaborations titled "case studies and best practices in academia-industry collaborations". Still in progress, but this week I made progress in putting together resources in TTW and external to TTW useful for writing about best practices in academic-industry collaboration. (thank you to Vicky, Jen, Anne, Ale, Kalle, and Alejandro!) * [https://github.com/the-turing-way/the-turing-way/issues/3407](https://github.com/the-turing-way/the-turing-way/issues/3407) * [https://github.com/the-turing-way/the-turing-way/pull/3410](https://github.com/the-turing-way/the-turing-way/pull/3410) * My first merge! * [https://github.com/the-turing-way/the-turing-way/pull/3414](https://github.com/the-turing-way/the-turing-way/pull/3414) * ASK: Let me know of people who are doing research with industry and academia and might be interested in contributing to this chapter and/or benefit from this chapter! * Notes: * Get as many perspectives about resources that needs to be included. Still a working progress but it is start and pleased with what is at the moment * Thanks with everyone to supported and Vicky specially, mentioned above * First merged, something small but still very glad! * Questions / asks: nothing in particular but as always I'm interested in be in touch to talk about everyone who is interested in this subchapter, by contributing or using the material * Name: David Llewellyn-Jones * Notes: * I'm new to all this (I'm used to being at the reading end of TTW) so it took me a while to get the hang of things. * The Onboarding and git sessions were really helpful. * Kalle Westerling was a real inspiration: it was a joy to watch their PRs and reviews flow through the system. <3+1+1 * The first half of the week I spent doing small editing tasks and reviews. Typos, Twitter, cross-references. * The second half of the week I've been trying to tackle something more substantial: a new "When reviews go wrong" page in the **Reproducible Research/Code Review Process** chapter. * It's taken me a while to pull the material together, but I now have a structure and notes for each section, so it's getting there. * If I'd got to this point earlier, I think I could have worked more collaboratively. I should have asked for feedback earlier. * While working on the Twitter changes I became increasingly convinced that adding in material about Mastodon would be a good idea. I'm hoping this can be something for the future.Seconded * Working with Calum from Scriberia was a joy. He immediately took my half-baked idea, turned it into something tangible and ran with it. * It was an amazing week! * Links to Issues and PR: * Fixing typos in the Community Handbook: * Issue: [https://github.com/the-turing-way/the-turing-way/issues/3346](https://github.com/the-turing-way/the-turing-way/issues/3346) * PR: [https://github.com/the-turing-way/the-turing-way/pull/3347](https://github.com/the-turing-way/the-turing-way/pull/3347) * Switching Twitter for X: * Issue: [https://github.com/the-turing-way/the-turing-way/issues/3357](https://github.com/the-turing-way/the-turing-way/issues/3357) * PR: [https://github.com/the-turing-way/the-turing-way/pull/3396/](https://github.com/the-turing-way/the-turing-way/pull/3396/) * Rationalise Cross Reference examples * [https://github.com/the-turing-way/the-turing-way/issues/3349](https://github.com/the-turing-way/the-turing-way/issues/3349) * [https://github.com/the-turing-way/the-turing-way/pull/3392](https://github.com/the-turing-way/the-turing-way/pull/3392) * 4. Some PR reviewing (should have done more!): * [https://github.com/the-turing-way/the-turing-way/pull/3376](https://github.com/the-turing-way/the-turing-way/pull/3376) * 5. Scriberia Illustration * For the "When Review Goes Wrong" subchapter... in progress * 6. For the future: * Small issue to fix: [https://github.com/the-turing-way/the-turing-way/issues/3356](https://github.com/the-turing-way/the-turing-way/issues/3356) * Add material about Mastodon: [https://github.com/the-turing-way/the-turing-way/issues/3359](https://github.com/the-turing-way/the-turing-way/issues/3359) * ASK: * The "When Review Goes Wrong" page is still very early work-in-progress, but any high-level feedback would be appreciated. Is this a sensible addition, or just making things too complex? * Notes: * Really amazing experience - from the onboarding and github training experience * Kalle has been an inspiration to see how he went into the PR * Very pleased to see the Twitter PR reviews that just got merged today * Feedback about the direction of the "When reviews goes wrong" * It would be great to have some stuff in Mastodon from the book * Working with Calum has been amazing experience * Questions: how was the experience of writing about Twitter, surprised to see how much material there is * Notes PM Shareout: * David shared his chapter "when code reviews go wrong" and his Scriberia illustration * power struggles, the infinite wait, the infinite review, bad contributions are better than no contributions, the weight of responsibilities, impulsive reactions * Name: Batool Almarzouq * Links to Issues and PR: * HackMD Draft that all PMs and Kalle (RAM): [https://hackmd.io/t2Bnqwt8Qv6GPpWvH3iRzQ?both](https://hackmd.io/t2Bnqwt8Qv6GPpWvH3iRzQ?both) * Issue: [https://github.com/the-turing-way/the-turing-way/issues/3424](https://github.com/the-turing-way/the-turing-way/issues/3424) * PR fixing the issue: [https://deploy-preview-3430--the-turing-way.netlify.app/project-design/logical-frameworks-overview](https://deploy-preview-3430--the-turing-way.netlify.app/project-design/logical-frameworks-overview) * PR: [https://github.com/the-turing-way/the-turing-way/pull/3430](https://github.com/the-turing-way/the-turing-way/pull/3430) * Another PR to re-organise the Project Design: [https://miro.com/app/board/uXjVNPYo3M4=/](https://miro.com/app/board/uXjVNPYo3M4=/) * ASK: * Notes: * How to reorganise PM's materials with Kalle and Arielle * Theory of change review - logical frame, would love to have people reading it and collaborating in that chapter * What was it about to write about Theory of change: reflect on it itself and how it has been used in different contexts. The process is not linear but with lots of loops and irregular process * Name: Sarah * Links to Issues and PR: [https://github.com/sgibson91/test-multilingual-sphinx](https://github.com/sgibson91/test-multilingual-sphinx) (it's a repo) * ASK: * Notes: * Making the Book available in different languages. * Learnt a lot, transferable knowledge from different partners useful with other partners like Carpentries, Metadocencia, etc. * Cool week for learning * It was fun to come back to the Book Dash * Name: Saranjeet * Links to Issues and PR: * [https://github.com/the-turing-way/the-turing-way/issues/3348](https://github.com/the-turing-way/the-turing-way/issues/3348) * Will be transferred into a PR soon (Ale is happy to collaborate) * ASK: * Note: * Meta check list for the Book Dash Planning committee * Write down all the responsibilities of the day leads and session hosts and additional responsibilities * Starting sessions at 8:00, we need to rethink if all the operation work by someone who has Turing addresses. Learning points. How to have alternate hosts to start on time * Break within the sessions. Smooth transitions for the next sessions. * Alex - adding your feeBook Dash Planning Committee * have all the knowledge integrated in the book, issue or Hackmd would be super useful for other teams. ---> Chapter for Community Handbook * Name: Accessibility Working Group - * Hi team! Thank you for speaking earlier. I'm adding a few notes here from our discussion. Please feel free to change anything! :) * **Notes from: ** * Wonderful collaborators from Metadocencia and folks within the Accessibility working group have been reviewing the new "Guide for Running Accessible Events" series, which prompted an important discussion in the group. * These texts were prepared using terminology aligned with the 'medical' model of disability (in contrast to the 'social model'). This included phrases such as "people with lived experience," which were too indirect. * see more: [https://www.ombudsman.org.uk/sites/default/files/FDN-218144\_Introduction\_to\_the\_Social\_and\_Medical\_Models\_of\_Disability.pdf](https://www.ombudsman.org.uk/sites/default/files/FDN-218144\_Introduction\_to\_the\_Social\_and\_Medical\_Models\_of\_Disability.pdf) * This prompted a wider discussion about how we as a community define access, and how we want to be inclusive? * **Upcoming plans** * Accessibility Guidelines (ACCESSIBILITY.md): [https://github.com/the-turing-way/the-turing-way/pull/3146/files](https://github.com/the-turing-way/the-turing-way/pull/3146/files). These are the standards we aim to hold ourselves accountable to. * We will add written guidance for the language that people should use * We aim to integrate a feedback process that will allow the working group to improve the language and inclusivity of the guides (like a code of conduct) * Document current practices (however imperfect) in Community Handbook * ALS \& AAA will document what we are doing currently * Accessibility WG will review \& iterate * Accessibility Guide: * We are drafting our landing page, but would like to add clarifying language around the difference between the medical model and the social model understanding of disability, as well as greater context about access in the context of language, geography, connectivity, etc. This framing language will shape how the guide is written. * We will also create a skeleton of how to organise existing materials \& write new materials * Links to Issues and PR: * Add all links here? * ASK: What do we mean when we say we would like to be an inclusive community? * Notes: * Feedback about terminology indeed - I thought there were two groups but it seems it is indeed meant as one general group in terms of accessibility? Because then lived experience seems a bit odd * Lots of learnings working with the working groups, thoughtful contributions about the right way to proceed * Name: Ale * Links to issues and PR: * Thanks to Kalle - reviewing PR's and pushing to * Encourage Governance contributions (Anne, Esther, Anne) * The turing way Practitioners Hub: thanks Batool. Activity plan, training sessions * Susana: in-person suggestions for more inclusive snacks * ASK: * Notes: * The energy in this Book Dash has been super high! * Thank you to Kalle for supporting in so many pull requests – nominating the hero * Thank you to Sarah and Esther about documentation around feedback about governance * The Experts in Residence cohorts ends at the end of December * Thank you to Batool who helped with the EiR d * Thank you Susana - running in-person hub, learning to buy inclusive snacks. Vegan snacks! * Inclusive snacks: I’m working out vouchers for home delivery with this company - doughnuts by post! [https://doughnuttime.co.uk](https://doughnuttime.co.uk) * Name: Arielle * Links to issues and PR: * Thanks to Kalle * ASK: * Notes * A nice crew from the Americas * Shout to Gigi, as she was joining despite the time * [https://github.com/the-turing-way/the-turing-way/issues/1205](https://github.com/the-turing-way/the-turing-way/issues/1205) * Learning from the book dash: Get something on the book first and then follow it up with issues * Shareout: Kalle, the star of the week, Batool with the project framework, lots of collaboration with them * How to get started with a project - work in progress- Ale, Batool and David would be glat to help * Thank you everyone, sad the book dash is over now * Name: María Nanton * Links to issues and PR * Merged! [https://github.com/TWTranslation/Spanish\_specific\_translation\_guidelines/pull/1](https://github.com/TWTranslation/Spanish\_specific\_translation\_guidelines/pull/1) * About to merge! [https://github.com/the-turing-way/the-turing-way/pull/3431#](https://github.com/the-turing-way/the-turing-way/pull/3431#) * Notes * It was great working along members of the translation \& localization team! * Thank you so much Alejandro, Andrea and Batool for encouraging and supporting me to make these contributions * Thrilled to help make available to others the awesome work Alejandro, Camila and others had started with the spanish translation guidelines <3 * Notes: live merged of the pull request!! huge exciting * Name: Esther * Links to issues and PR: * Together with Emma we did the quickest Issue/PR ever on finding data: [https://github.com/the-turing-way/the-turing-way/issues/3360](https://github.com/the-turing-way/the-turing-way/issues/3360) * Did a big update on the RDM chapter, including new sections on data repositories, methodology/electronic labnote books and a drafty data visualisation section! * [https://github.com/the-turing-way/the-turing-way/pull/3214](https://github.com/the-turing-way/the-turing-way/pull/3214) (thanks Anne, Saranjeet, Arielle and Alejandro for the reviews!!). Some of the content was also worked on by Emma, Eirini and Lena! * Added a couple of resources to the Open Education section: [https://github.com/the-turing-way/the-turing-way/pull/3412](https://github.com/the-turing-way/the-turing-way/pull/3412) (Thanks Kale for review!) * Session organised by Emma on adding images was very inspiring! I added several images in the RDM update and to the cultural change section [https://github.com/the-turing-way/the-turing-way/pull/3408](https://github.com/the-turing-way/the-turing-way/pull/3408) (thanks Arielle for writing a much nicer alt-text for the image!) * Chatted about governance - thanks Anne/Ale for facilitating these discussions! * Read all the things about the inclusive event PRs started by Sophia! * Ask: Also opened up a new issue on the feedback process: if you have any resources/thoughts please weigh in: [https://github.com/the-turing-way/the-turing-way/issues/3361](https://github.com/the-turing-way/the-turing-way/issues/3361) * Notes: * Contributed content in comparison of the previous book dash where I had to organise a Local hub * Finding data issue was opened * Name: Alejandro * Appreciations * Amazing week with new and old faces in TTW book dash * Nice chats with Maria N and Patricia from Metadocencia about the history of the Spanish translation team and trainings on satellite image technologies * Calum for quickly capturing complex ideas into nice illustrations * Anne F for joining the Scriberia session with Calum * Accessibility funds of the Book Dash for the childcare support. Matilda had a great company and time with her babysitter, Marjana. * Gave back (PRs reviewed - all them amazing contributions): * Esther (Research Data Management): very interesting stuff about Data Repositories * Maria (TTW Spanish Translation Guidelines): thank you for bringing fresh ideas! * Julien C (Open Hardware): very insighful for me and pertinent for some colleagues working on Open Hardware for Environmental monitoring and education * Richard (Ethical Licensing): this requires further reading, but it was so informative to learn about the fundamental freedoms of free/libre software and ! This is very relevant to a project I'm participating about Open Computer Vision. * Notes: * Alejandro's sixth week, very nice week hahaha late Thanks to the amazing Planning Committee November 2023 <3 - Andrea Sanchez-Tapia - Anne Lee Steele (Operational Support) - Alexandra Araujo Alvarez (Operational Support) - Arielle Bennett: - Batool Almarzouq: - Emma Karoune: - Esther Plomp: - Johanna Bayer: - Liz Hare: - Saranjeet Kaur: - Susana Roman-Garcia: - Winny Nekesa ## ## Attendees to the Working group Share-out Activity 1: Introduce yourself Activity: working group share-out Notes from Working groups Share out NOTES Translations and localisation - Sarah can we render instead of from English to other languages, from other languages to English * Andrea: We have discussed not centering English, for example in Accessibility, but we have no idea about the deployment part. Infrastructure * we move to our own Github organisation, we can create teams, phases how we would like to work together * next thing is splitting repositories - moving the project * barriers: capacity to fullfilled our dreams, we need deep focus to move practical things forward as there's no time to implement - "tell me what to do and I will do it" invitation from Sarah * Book repositories, with maybe working groups repo, opinions needed * External model for pathways. Greated with a landing page with a personal that introduce you to different parts of the book * Contribution guidelines across who can create repositories, how, structure of repos, code of conduct, etc. ---> this, repo splitting will not be created as a infrastructure sylo but as a community effort Environmental Data Science Book * Collaboration with TTW Community, on behalf of the communities * Fireside Chat about computational impact very well received * Looking for more contributions * Accessibility * How do create accessible spaces - who are we inclusive to? * * * * * * Questions and reflections Please add your questions/reflections from *The Turing Way* here * * * * * * * #### Have questions or feedback to organisers? Have ideas for how you would you like to get/stay involved? Please add them here. (2-3 min silent note taking) * * * * * * * #### Thank you for joining us! Questions and Reflections Please add your questions/reflections from *The Turing Way* * * * * * * * * ## Pluses and deltas - Final Feedback Document for Book Dash attendees IMPORTANT: Please take a few minutes to share your highlights as a comment under issue #Update and provide feedback (pluses and delta) from the event. *These will be extremely valuable for us to explain to our funders why this event was valuable, and to learn about your experience, what you enjoyed and how we can improve future events.* * [https://annuel2.framapad.org/p/ttw-bookdash-nov2023-feedback](https://annuel2.framapad.org/p/ttw-bookdash-nov2023-feedback)