This is the sort of thing I write into "notes.txt" and check in to source control as a support document. Writing your notes in a bound notebook as un-OCR-able calligraphy, and then scanning the results to image files is not likely to endear you to me as a co-worker.
Paper is dead, long live paper programming
81–89 of 89 posts
Re: Paper is dead, long live paper programming
#82This is the sort of thing I write into "notes.txt" and check in to source control as a support document. Writing your notes in a bound notebook as un-OCR-able calligraphy, and then scanning the results to image files is not likely to endear you to me as a co-worker.
Re: Paper is dead, long live paper programming
#83Earlier quoted context omitted.
You'd rather have plain text than hand-written diagrams? I think most of the difficulty is in not knowing APL like notation.
Yes, but I have a tool for making images on my computer, too. The handwritten bound notebook cannot be searched, diff'ed, or versioned. It is strictly inferior to the plaintext file in most ways that are in any way relevant to writing software. Its nemesis, of course, is and has always been the mathematical equation, whose notations confound the plaintext writer at every turn. For those, you can write it to an image,…
Re: Paper is dead, long live paper programming
#84Earlier quoted context omitted.
So searching an image is definitely nice, but it's a tradeoff in my opinion as it takes much longer to write out an equation in equation editor (I'm very proficient btw) or the other mathematical CAD tools I use when compared to a Notebook sketch. I use them all the time, take a pic and put it in OneNote with some keywords to search.
Learn LaTeX and stop wasting your time with equation editors.
Re: Paper is dead, long live paper programming
#85In 1992 for my final pre-exams deliverable at uni I wrote the entire program text (in Pascal) out on pen and paper overnight, fuelled by cheap lager and Red Bull. Queued at the door waiting for the lab to open in the morning, then typed the lot in and was delighted to discover not only no syntax errors, but no bugs. Ran it, took a few screenshots, printed them and the listing, delivered it to my tutor and went to the…
Where did Red Bull exist in 92'? Dang...wikipedia says it came out in 87'. I can't recall energy drinks before ~2003.
Re: Paper is dead, long live paper programming
#86Earlier quoted context omitted.
Yes, but I have a tool for making images on my computer, too. The handwritten bound notebook cannot be searched, diff'ed, or versioned. It is strictly inferior to the plaintext file in most ways that are in any way relevant to writing software. Its nemesis, of course, is and has always been the mathematical equation, whose notations confound the plaintext writer at every turn. For those, you can write it to an image,…
This assumes that the purpose of the doucment is to be archived, searched, diffed and reproduced. None of these is in fact the case. The purpose is as a tool in the production of the program being written.
It is just as important to control process documents as it is to control source code files.
Re: Paper is dead, long live paper programming
#87Earlier quoted context omitted.
This assumes that the purpose of the doucment is to be archived, searched, diffed and reproduced. None of these is in fact the case. The purpose is as a tool in the production of the program being written.
And you don't think that should be put into source control? It is just as important to control process documents as it is to control source code files.
Re: Paper is dead, long live paper programming
#88In 1992 for my final pre-exams deliverable at uni I wrote the entire program text (in Pascal) out on pen and paper overnight, fuelled by cheap lager and Red Bull. Queued at the door waiting for the lab to open in the morning, then typed the lot in and was delighted to discover not only no syntax errors, but no bugs. Ran it, took a few screenshots, printed them and the listing, delivered it to my tutor and went to the…
Where did Red Bull exist in 92'? Dang...wikipedia says it came out in 87'. I can't recall energy drinks before ~2003.
Re: Paper is dead, long live paper programming
#89Earlier quoted context omitted.
I do all my coding in gregg shorthand
I know this was a joke, but do you by any chance know any shorthand? I tried to teach myself Gregg here and there years ago, but it requires more dedication than I was willing to put in to become fluent.