Diary Study Example.md

📓 tBTC & Random Beacon Node Setup Diary

🟣 The Write-Along Technique

An easy method to log your activities and actions is the Write-Along Technique. With this technique, you will record your actions, with detailed information, throughout your entire journey. This will allow you to record the information about your events as they occur.

This technique ensures that relevant information is captured in situ before being forgotten. This type of data recording will require providing extensive detail at the time of capture.

🟣 The Snippet Technique

A method for logging your activities is the snippet technique. With this technique, you can only record short snippets of information about your activities as they occur. Then, at the end of each day, or when you have time, you elaborate on each snippet by providing additional details about the activity.

This technique ensures that relevant information is captured in situ, before being forgotten but without requiring you to provide extensive detail at the time of capture.

👉 For both techniques, you can come back to your diary entry at any time along your journey and add more details.

How it works

• You will be required to create a Diary Entry Gist, private or public, which you must share with me via e-mail when the study begins.
• You must fill in a Diary Entry study each day of your Node Setup. For some, the Setup will take one day, for some will take more, and it's all right. No matter how long it takes, you will need to input a Diary Entry Gist each day by EOD.
• I will regularly ping you if you forget to submit a Diary Entry Gist.
• During the study, if you have any questions, ask them away but keep in mind that I might not know the answer to some of the questions or I will refrain from answering them, so I do not prime you.
• After your last entry, you will receive a short survey.

I will regularly check each day all of your entries and prepare follow-up questions that we will discuss during the Post Diary Interview.

🔠 How to track your actions during the study

Diary Entry Example

Day 1

I've received my testnet tokens and the private testnet invitation. I've checked what are the machine requirements for the node setup. I decided to use Digital Ocean so I had to go and create an account. I used to use X but now I want to switch to Digital Ocean because my firends kept on schilling it.

I've read the Documentation and I think [user thoughts]

After reading the Docs I set up my Ubuntu machine on X cloud provider. The process was very easy because their interface is intuitive and it only took a few minutes ...

After setting the basic machine up, I downloaded the node from this link. It was very difficult to install because ..., but I overcame that by ...

Day 2

After having access to the binary I was able to run the node with this command and got this output:

$ ./client-code 
...

I knew I wasn't done because I also want to set up a system service to make sure the node still runs even if the server is restarted.

[Describe service setup]

Day 3

After I decided my node was set up successfully because it was printing

insert node prints from CLI
...
...

I started monitoring my node by setting up X and Y.

Gist Diary Entry Example here