> For the complete documentation index, see [llms.txt](https://yoan-thirion.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yoan-thirion.gitbook.io/knowledge-base/software-craftsmanship/the-programmers-brain/how-to-read-code-better.md).

# How to read code better

Workshop to demonstrate how our programmers brain work.

### Objectives :

* Understand how our brain works in front of code
* Get some tips to improve our daily life
  * Flashcards to learn quickly new syntax / spaced repetition
  * Chunking code strategies
  * Techniques to read complex code

## Connection - Code reader 10'

![](https://1936518372-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAffO8xa1ZWmgZvfeK2%2F-MiegcV81pgbtr3ElNVS%2F-MiegjCnc_ZOIW6jxbLp%2Fimage.png?alt=media\&token=a9d23b8d-b409-42fb-8786-ac30792809d4)

Ask participants to :

* Choose a code snippet
* Take a few minutes to read / understand it - 5'
* Add notes on your snippet - 5' 
  * Why did you choose this piece of code ?
  * What makes it easy to understand the code ?
  * What makes it hard to understand the code ?

{% file src="/files/-Miegrl65D3iU\_7WaQzc" %}
Code snippets examples
{% endfile %}

Debrief it and relate to the confusion related to code.

## Concepts - 30'

{% embed url="<https://speakerdeck.com/thirion/the-programmers-brain-read-code-better>" %}

## Concrete Practice -  Create your own Flashcards 10'

* Think of the top 10 programming concepts you always have trouble remembering
* Make a set of flashcards for each of the concepts and try using them

**Example** :

![](https://1936518372-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAffO8xa1ZWmgZvfeK2%2F-MiehfvXZAxLdvLCgr1d%2F-Miejuuvw1Ei-5XEM4Rk%2Fimage.png?alt=media\&token=cafb7a7d-9336-4b7e-b98c-8e7c19a1cc1e)

## Conclusion - 5'

* Debrief on the learning of the day
* Ask participants to stick their name
* Ask them why here

![](https://1936518372-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAffO8xa1ZWmgZvfeK2%2F-MiehfvXZAxLdvLCgr1d%2F-Miek50oP5ZHWIs-RqUR%2Fimage.png?alt=media\&token=3dc9c9a0-8c48-40d4-a243-2a86a86db6db)