If you need help or have any questions/feedback on this process, check the wiki in the gitshow admin repo. If you can't find help there, check the issues threads in the admin repo or post a new issue there. Make sure to tag @michaelpalumbo in your issue.
IMPORTANT: the following files are the ONLY documents you are permitted to edit:
Please only edit these files and do not rename them. Do not modify the readme, markdown_examples, .gitignore, or any of the files in /admin or /web. Thanks!
This process will take ~10 hours per week to complete.
It is extremely important that you follow the exact steps detailed in this document every week, as Michael may have added modifications to the process based on feedback.
Clone the repository you've been assigned and open it on your computer
open reflections.md in a markdown editor, erase all of the content, and save the file. Leave this document open.
open score.md, and read it at least once.
listen to recording.wav several times and follow along with score.md
in score.md, copy (NOT CUT) the entire markdown code (not the rendered preview) of the document and paste it into the newly blank reflections.md.
Close score.md.
In reflections.md, using markdown formatting, place the entire score in blockquotes by inserting the > symbol at the start of each line of the score, including line breaks. (in MacDown you can select entire text and type Shift-CMD-B). This will add a threadline in the rendered document i.e. a score with the > added to each line becomes:
low, sustained tone at medium intensity, gradually fades over ~45 seconds
medium and higher transients like clicks, pops, and buzzes are introduced gradually
note that if blockquotes were used as part of the score to begin with, you can add a second > symbol to the line:
example of a double block quote
example of a triple block quote ...
Save reflections.md, and make a commit
git commit -am "beginning to reflect on the score and recording"With the score now in blockquotes, continue to listen to the recording, but now insert your own reflections on the score and recording, making specific notes below areas of interest, and also noting the time(s) in the recording.
low, sustained tone at medium intensity, gradually fades over ~45 seconds
I notice that while the score states that this low tone gradually fades over 45 seconds, I mostly only hear a fade begin around 33 seconds in.
medium and higher transients like clicks, pops, and buzzes are introduced gradually
Further to the previous note about the later fade, I think that these clicks and pops would be more effective if the fade were indeed introduced sooner. Also, the transient at 0:37:13 is less of a click/pop/buzz, and more like a hard 'k' sound.
Save and commit your changes very often, be generously descriptive in your commit messages!
continue to listen to the score and make notes. Some suggestions for what you could focus on:
Reopen the score.md, and then open the file patch.vcv in VCV Rack, and experiment with performing the score several times. Add notes about this process in the reflections.md document, remembering to save & commit your changes.
Begin to compose a new version of the score in score.md and make a newer version of patch.vcv:
Practice performing the score (maximum length is 90 seconds!).
To record yourself, locate the record module in the patch (or add one if it isn't there). Right-click it, and ensure the following settings:
Each time you record using this module, it will overwrite the previous recording.wav, so remember to commit each version of recording.wav.
When the score, recording, and patch are completed, save and commit any last changes, and update the remote github repo:
git commit -am "type a message about this commit..."
git pull
git push
```>