I was recently asked
by a student for some advice on keeping a project log. That started me thinking
about the subject in general and lead to this post as I thought it may be of
more general interest.
Why a Project Log?
From a strictly
TM470 perspective a project log helps remind you what you done, provides
evidence of tracking and monitoring and can be a source of material for
reflection, so it can address several of the learning objectives. Beyond that a
project log is a useful tool in itself - I work on several "hobby
projects" and keep a project log for my own use, of which more later…
What Form Should it
Take?
We have lots of
options here:
Audio / Video
recording - this seems to be a staple of science fiction shows ("Captain's
log, stardate 2345.1, the Enterprise is delivering urgent supplies…")
however I think in reality this is more of a plot exposition device than a
useful medium - it is hard to search (and to incorporate into your TM470
report…)
Note taking apps:
these vary from free (Apple Notes) to actually quite expensive (£80 / year for
Evernote) but for great extensibility and flexibility I would recommend
Obsidian which is available for free on all platforms. Obviously text notes can
be easily incorporated into your reports, quickly searched and you can copy and
paste in URLs, code samples or whatever. They may not be ideal for the slow
typist, or someone who likes lots of diagrams.
Note taking devices:
Things like the "Remarkable tablet" appear to be a good compromise
between hand written and electronic notes but the device itself is expensive
(£379 minimum) and you may need to pay an ongoing subscription to make full use
of it but it is well reviewed and a good size. I do have an Amazon Kindle
Scribe which provides a surprisingly good writing experience, little to no lag
and matt surface that feels like paper but the smaller size of the writeable
area (just a bit bigger than A5) I find a bit restrictive.
Physical notebooks:
My preferred medium. Available in a huge range of formats, my favoured choice
is a ring-bound, hard-backed A4 book with wide ruled lines. Hardback so you can
rest it on your knees, and ring bound so it can lie flat for writing on both
sides of the page. The obvious advantages here are that you can be completely
free format and write in pencil, ink, add colours, stick things in and
generally make it your own. I'm a bit of a pen fetishist and prefer a fountain
pen for handwriting (A Kaweco Sport in solid brass, with Monte Grappa ink) and
a technical fine-liner for diagrams (Uni-pin Fine-liners 0.1 to 0.5 for
diagrams that are *so* deep black, and Staedtler 308 pigment liners for
colour). Clearly the problems with
hand-written notes are searchability and incorporating them into your TM470
report, again more on this below. For long-term archiving purposes (and
insurance against my notebook getting lost or stolen) every so often I
photograph each page using the Microsoft Lens app on my phone and store the
resulting PDF on a cloud storage service.
What Should I Write
in my Log?
This is up to you.
Some logs are strictly formal, adhering to a rigid format - my own have
expanded somewhat to include reflections on the day, thumbnail reviews of books
and TV shows and doodles, all of which is fine, it is your log! Indeed, lots of
diagrams, sketches and colours can actually make your notes easier to search,
rather than flicking through turgid pages of identical text.
Restricting myself
to just project notes, here are the things that I try to include when logging:
What I'm intending to do each
day
What I did do each day
How I felt about that
Any lessons learnt, good or
bad
Useful commands / websites,
especially if was something that I used to solve a particular problem
Rough drafts of planning or
design diagrams
Things I still need to do
(Marked with a big TODO, so that I can both find them, and cross them out
when they are done)
What Should I
include the final report?
Probably NOT the
whole project log, it will not be read and just adds unnecessary pages. You can
obviously use the log as the source for your reflection, even quoting yourself
if you want to (so with a hand-written log you are only typing up small fragments)
and by all means include photographs or extracts of interesting pages, with
annotations or further discussion if you want. Extracts in the main body of the
document, included as evidence of your project logging activities are more
likely to be read (and appreciated) than 50 pages of appendix F…
Over to You
These are just my
thoughts, what do you think? Any suggestions, hints or tips? What is your
project logging approach?
The Project Log
I was recently asked by a student for some advice on keeping a project log. That started me thinking about the subject in general and lead to this post as I thought it may be of more general interest.
Why a Project Log?
From a strictly TM470 perspective a project log helps remind you what you done, provides evidence of tracking and monitoring and can be a source of material for reflection, so it can address several of the learning objectives. Beyond that a project log is a useful tool in itself - I work on several "hobby projects" and keep a project log for my own use, of which more later…
What Form Should it Take?
We have lots of options here:
Audio / Video recording - this seems to be a staple of science fiction shows ("Captain's log, stardate 2345.1, the Enterprise is delivering urgent supplies…") however I think in reality this is more of a plot exposition device than a useful medium - it is hard to search (and to incorporate into your TM470 report…)
Note taking apps: these vary from free (Apple Notes) to actually quite expensive (£80 / year for Evernote) but for great extensibility and flexibility I would recommend Obsidian which is available for free on all platforms. Obviously text notes can be easily incorporated into your reports, quickly searched and you can copy and paste in URLs, code samples or whatever. They may not be ideal for the slow typist, or someone who likes lots of diagrams.
Note taking devices: Things like the "Remarkable tablet" appear to be a good compromise between hand written and electronic notes but the device itself is expensive (£379 minimum) and you may need to pay an ongoing subscription to make full use of it but it is well reviewed and a good size. I do have an Amazon Kindle Scribe which provides a surprisingly good writing experience, little to no lag and matt surface that feels like paper but the smaller size of the writeable area (just a bit bigger than A5) I find a bit restrictive.
Physical notebooks: My preferred medium. Available in a huge range of formats, my favoured choice is a ring-bound, hard-backed A4 book with wide ruled lines. Hardback so you can rest it on your knees, and ring bound so it can lie flat for writing on both sides of the page. The obvious advantages here are that you can be completely free format and write in pencil, ink, add colours, stick things in and generally make it your own. I'm a bit of a pen fetishist and prefer a fountain pen for handwriting (A Kaweco Sport in solid brass, with Monte Grappa ink) and a technical fine-liner for diagrams (Uni-pin Fine-liners 0.1 to 0.5 for diagrams that are *so* deep black, and Staedtler 308 pigment liners for colour). Clearly the problems with hand-written notes are searchability and incorporating them into your TM470 report, again more on this below. For long-term archiving purposes (and insurance against my notebook getting lost or stolen) every so often I photograph each page using the Microsoft Lens app on my phone and store the resulting PDF on a cloud storage service.
What Should I Write in my Log?
This is up to you. Some logs are strictly formal, adhering to a rigid format - my own have expanded somewhat to include reflections on the day, thumbnail reviews of books and TV shows and doodles, all of which is fine, it is your log! Indeed, lots of diagrams, sketches and colours can actually make your notes easier to search, rather than flicking through turgid pages of identical text.
Restricting myself to just project notes, here are the things that I try to include when logging:
What Should I include the final report?
Probably NOT the whole project log, it will not be read and just adds unnecessary pages. You can obviously use the log as the source for your reflection, even quoting yourself if you want to (so with a hand-written log you are only typing up small fragments) and by all means include photographs or extracts of interesting pages, with annotations or further discussion if you want. Extracts in the main body of the document, included as evidence of your project logging activities are more likely to be read (and appreciated) than 50 pages of appendix F…
Over to You
These are just my thoughts, what do you think? Any suggestions, hints or tips? What is your project logging approach?