Skip to the content.

CERSE Meeting Handbook

Contents

Overview

This is an evolving document - if you have something to add or change please contribute.

This document offers guidance on how to organise a Community of Edinburgh Research Software Engineers (CERSE) meeting. We believe that these meetings should be inclusive and available to all. We have adopted the Carpentries Code of Conduct, please make yourself familiar with this and inform participants at the meeting that they should observe this.

Infrastructure

We have set up some infrastructure to help organise such meetings:

We have made these institution independent so as to be available to all interested parties in Edinburgh.

Process

Venue requirements

Unless you intend your meeting to be a virtual your first task will be to find a good venue. A good venue should, where possible, have :

The venue should be available for around two hours - this has been the typical duration for the meetings up to this point.

Virtual meetings

Like with finding a good venue you will have to choose a virtual platform:

Before the event

This starts from the premise that a suitable venue has been booked for this event.

Before you can do anything get yourself added to the GitHub CERSE Organisational. We are assuming that you are going to be coordinating a future CERSE meeting in Edinburgh. We use GitHub.io pages to publicise meetings and log outcomes so it is important that you have a GitHub id with sufficient privileges within the CERSE Organisation to be able to do this.

  1. Create a public repository with a name that uses the yyyy-mm-dd-venue pattern for your meeting. Make sure you create under the cerse organisation and that it is a Public repository.
  2. Go into your repository and click on Settings (Gear icon).
    • Choose the Pages menu item on the left-hand menu.
    • Change the Source to Deploy from a branch and choose the branch to be main and the root to be / (root) and remember to Save (your io pages will be generated from your markdown pages in the repo starting from a README.md file).
    • When you make this change GitHub will inform you where your GitHub io pages are published. It will follow the pattern: https://cerse.github.io/YourRepoName. Take a copy of your io pages URL.
    • If you copy the _config.yaml from another repo to use the Cayman theme as that gives a better accessibility score.
    • Go back to your repo page.
  3. Click on the Edit button to modify the message No description, website, or topics provided.. If you do not see this button ask for your privileges to be increased. Add a short description for your event but more importantly add the GitHub io pages URL for your website.
  4. Create a Readme.md file. Populate with the contents of a previous event. Begin to edit with the corresponding content for your event.
  5. Go to the cerse.github.io repository which contains the main pages for the organisation. Add your event, in reverse chronological order, to the list of existing events. Make sure you point to the GitHub io pages and not the repository.
  6. It can be useful to set-up a registration process to know how many people are coming to the event (especially if catering is being provided) and to generate an attendee list. For this you could use:

Timetable for the day

The programme for the day will depend on how you want to shape the day. See the template file you can use to seed your repository - you need to name this file Readme.md in your repository.

Typically we have used the following pattern:

Time Activity
15:00 Welcome
15:05 Presentation possibly from the venue volunteer
15:25 Ice breaking session (opportunity to get to know your fellow attendees) or a group activity
15:45 Lightning talks or discussion breakout groups
16:00 An RSE focused presentation
16:30 Coffee and biscuits
17:00 Close

where the times are flexible depending on the content. In more detail:

This is only an example timetable - please feel free to change so that it best fits your needs. Coming up with the timetable for the day can be one of the hardest things to sort out for your meeting.

Lead up to the event

Once you have a first draft complete version of the GitHub pages for your event and a registration page,if you are going to use one, it is time to advertise, advertise, advertise. Hopefully, you can get some advice on good channels from existing member to do this.

Some suggestions are:

An email idea you may wish to use riff around:

Hi,
    Apology if you get this message more than once via different
channels.

The **Nth** meeting of the Community of Edinburgh Research Software
Engineers (CERSE) will be held on the **Date** at **Time** in **Location**.

Anyone who is involved with, or interested in, the development, use,
support or management of research software is very welcome to attend.

The event will have

**Programme**

Some refereshments will provided with time to meet new people will be provided at the end of the meeting. **Thank the sponsors**.



To get an idea of numbers for catering please register at:
**Registration link**

Further information: **Meeting URL**

Please circulate to anyone in the Edinburgh area who you think may be
interested.

Keep a log of where you publicise the event and when. You do not want to SPAM the same people too many times.

On the day

For the day you will need:

At the end of the meeting ask the audience if anyone would like to volunteer the next or a future venue. Give priority to venues that have not been used before or that are in separate geographical location in Edinburgh.

After the event

Make sure that you have copies of any material that was presented and that you have permission from the content providers that it is ok to add their content online through your event repository. Note the names and email addresses of any scribes so you can get content from them afterwards.

Timeline

At the third CERSE meeting it was thought that scheduling a bimonthly meeting would work best. This section attempts to give a suggested timeline on how to proceed. Assume an 8 week span between meetings which may be a bit optimistic but you can compress (or expand) the suggestion to fit the time that is available to you. We start from an assumption that the venue for the next CERSE meeting is decided on, or soon after, one of these meetings.

The amount of advertising you have to do should be informed by the number of (or lack of) registrations you have already (another good reason why you should have a registration process). Expect about 30% of no shows on the day as well as some shows that did not register.