Questions and notes from workshop day 5

This document contains the shared notes activities, some direct identifiers have been removed.

Day 5 - 30/9/2026

Icebreakers

:::info Videos from past days are now on CodeRefinery YouTube channel ! :::

Icebreaker

What (or where) will you (or do you think you'll have) for your next meal?

How do you take notes?

Lesson motivation

Is project documentation important? Why?

How would you describe a useful documentation?

How can you motivate your colleagues to contribute to the documentation?

What should a good documentation look like?

Other questions

How to document your research software

::: info

Break untill XX:00

:::

Sphinx and Markdown

:::warning

Exercise until XX:15

Exercise/follow along link: https://coderefinery.github.io/documentation/sphinx/#exercise-setting-up-a-sphinx-project :::

:::warning

Lunch break untill XX:00 (14:00 Finnish time)

:::

Responsible use of generative AI in assisted coding

https://coderefinery.github.io/coding-with-ai/

Exercise XX:35 - explore code generation with a chatbot

https://coderefinery.github.io/coding-with-ai/introduction/ (scroll to the bottom) :::success Go to https://duck.ai (no account needed) and try the following: Ask: “Write a Python function to calculate the standard deviation of a list” Look at the response. Does it:

Exercises with chatbots until xx:00 (we will have a short break after that)

https://coderefinery.github.io/coding-with-ai/scenario-full-control/#exercises

:::success

Break until xx:12

Remember to stretch your muscles and drink some water/tea/... :) :::

Your favourite IDE / tools?

Feedback for Day 5 of CodeRefinery workshop

:::success In the morning we covered documentation and how to publish github pages and in the afternoon we looked at responsible coding with AI. Thank you for the active discussions. The "AI lesson" is still work in progress, so any useful comment will help us improving it. Please answer the polls and questions below. :::

Today was (vote for all that apply):

too fast:o too slow: right speed:ooo too slow sometimes, too fast other times:o too advanced:o too basic: right level:oooo I will use what I learned today:oooooo I would recommend today to others:ooooooo I would not recommend today to others:oo

One good thing about today:

One thing to improve for next time:

Any other feedback? General questions?


Funding

CodeRefinery is a project within the Nordic e-Infrastructure Collaboration (NeIC).

Privacy

Privacy policy

Follow us

Contact

support@coderefinery.org

Improve this page

Source code