Digital Journal

From Coder Merlin
Within these castle walls be forged Mavens of Computer Science ...
— Merlin, The Coder
Alexander Liholiho's personal journal, 1849

Prerequisites[edit]

Background[edit]

Introduction[edit]

Your journey through these computer science experiences will benefit greatly by journaling. Each journal entry will have four parts:

  1. A brief journal header
  2. The second part of your journal will have a prescribed format. Here, you'll have the opportunity to ponder about phenomena that you've observed and answer some questions.
  3. The third part of your journal entry will address some open-ended prompts that will be the same for each experience.
  4. The final part is your opportunity to further explore the experience on your own.

Conventions[edit]

Journal Location and Name[edit]

All of your journals will be located in a subdirectory of your home directory, called "Journals". Let's create that directory now.

john-williams@codermerlin:~$  cd

john-williams@codermerlin:~$  mkdir Journals

john-williams@codermerlin:~$  cd Journals

john-williams@codermerlin:~/Journals$  

Each file will be named in accordance with the identifier of the experience with an extension of ".journal". Let's create the journal for experience W1002 and enter the editor:

john-williams@codermerlin:~/Journals$  emacs W1002.journal

Journaling Requirements[edit]

  • The first part of your journal will be a simple header with your name, the journal identifier, and the date that you started writing the journal. Type that into emacs now:

1 | Jane Williams
2 | Journal for W1002
3 | 18-May-2024
4 |
5 |

  • The second part of your journal will have a prescribed format, as determined by the specific observation boxes in that experience. As an example, consider the following two boxes from W1002:


ObserveObserveIcon.png
Observe, Ponder, and Journal: : Section 1
  1. Name at least two other services that you personally use which are implemented using a Client/Server Model


ObserveObserveIcon.png
Observe, Ponder, and Journal: : Section 2
  1. It appears that both Jack Williams and John Williams can have a directory of the same name. Do you think the ability to have two different users create a directory of the same name is important? Why?


These questions should be labeled in your journal using the convention Section.Question followed by a newline character. Use complete sentences and leave a blank line between questions. In this example, there are two sections with one question in each section. In emacs, we'd continue as follows:

 4 |
 5 |
 6 | 1.1
 7 | One of the other services that I use is...
 8 | Another of the services that I use is...
 9 |
10 | 2.1
11 | I think that the ability to have two different users...

The third section will address some questions that require a bit more thought. These same questions will be answered for each experience. Let's add these lines to emacs now:

12 |
13 | What did I learn? What is the "big idea"?
14 |
15 | What challenges did I encounter?
16 |
17 | How could this experience be improved?
18 |


  • The final part of your journal is titled "Free Reflection." It's an opportunity for you to reflect on your experience and how it has impacted your thinking.

Template[edit]

ComingSoonIcon.png
Coming Soon
  • Provide template to copy/paste into Journal
  • Add a helpful hint to create this file as Template.journal with instructions for copying

Exercises[edit]

ComingSoonIcon.png
Coming Soon
  • List labs that need to be reviewed and for which journals need to be created