4 ms·
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
by logfromblammo 9y ago
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.
- throwaway7645 9y agoYou'd rather have plain text than hand-written diagrams? I think most of the difficulty is in not knowing APL like notation.
- logfromblammo 9y agoYes, 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, or use LaTeX or MathML.
- throwaway7645 9y agoSo 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.
- Retra 9y agoLearn LaTeX and stop wasting your time with equation editors.
- throwaway7645 9y agoI'm right below the cusp where I think it will be more efficient to learn Latex.
- nicky0 9y agoThis 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.
- logfromblammo 9y agoAnd 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.
- nicky0 9y agoSure, take photographs of the pages and add the to them repo for future reference.
- MaulingMonkey 9y agoWith a paint program I can color code. With ASCII diagrams I can actually draw a straight line. With paper I can have eraser marks everywhere. (But I do use paper some - focus reasons, and easier to manage than terrible phone interfaces.)
- sheepmullet 9y agoIn practice I've found it takes ten times as long writing in a way co-workers can understand as it does writing personal notes. As such I'll mostly write personal notes for my own reference and make a judgement call about where I put in the 10x effort to communicate to co-workers. Your approach seems to couple problem solving with communicating with co-workers. Sometimes that's an advantage - often not.
- deleted 9y ago[deleted]
- nicky0 9y agoT hink the value of this is that it's part of the guy's thinking process. If it produces better designed code then it's good with me.