Updated recipes

I have been adding my personal recipes to malak.ca since the beginning of December, 2017.

It has been a sort of starting from fresh to create my personal cookbook, a project I started, I think, long before 2011 — as early as 2007-ish, as I recall.  (I remember discussing the cookbook with someone somewhere around 2012, and said conversation could not have occurred before 2011.)

Several years ago, I’d put together a personal cookbook, but at a certain point during its construction, somehow the main file either got corrupted, or I had several copies which I didn’t manage properly (and presumably, in this scenario, began overwriting previously entered recipes with newer versions of other versions.)  However it all happened, I became disillusioned and lost interest on a practical level to reconstruct it all, let alone finish it, despite a certain allure it had.

Back in December, I decided to start from scratch, doing a rather 90’s thing — or perhaps even an 80’s, or 70’s, or 60’s thing — I used a basic text editor and started retyping each recipe, sometimes using what I did still have as a reference, and in at least four cases, just reusing the recipe as I’d entered it back a few years ago, with the remnants of the original cookbook file.

In the case of some of recipes I’ve been typing in, I’ve actually been able to tune the text based on recent memory of just having made the items in the last couple of weeks (as in, as I was making the item in question, going over to my computer to make adjustments), or up to a couple of months ago.

I started posting pdf’s on my website.  And, I’ve been using a “post early, post often” approach to each recipe, as in, check recipes, fine tune them, repost the update, and, fine tune them again, adding sections like “equipment” as I’d start to be using that in other recipes, and so on.  I even have been recalling a lightning talk I rather liked at a linux conference I attended in 2011 which, ironically, used baking and recipes as a way to demonstrate the need to developers the importance of clear, concise, and complete instructions and documentation in order to encourage others to join their software projects.

And, fun fun fun, today I took advantage of another day of holidays, er, waiting for the garage to call me back and say that my car, in for servicing, was ready:  I went through all my recently-typed recipes and did some basic editing.  Lists and sentences / semi-sentences were capitalized.  Lists received dash points.  Instructions which hadn’t already been fleshed out, were fleshed out.  Sentences with multiple steps were broken up into discrete instruction lists.  A number received sections “do this part, then while that cooks, do this part”, etc.  (And then, transferring the updates to my webserver, to my laptop as a backup, and to my backup server which is also my webserver.)

Obviously, the likes of “cooking sausages” isn’t there, even though apparently when I make them for a Santa’s Breakfast, they are highly rated beyond the fact that I’m the only volunteer who actually relishes in making 200+ sausages at home in advance.  And, that having the sausages pre-cooked so that they only need to be reheated in the oven is quite convenient when you’re serving 100+ people.

Eventually, if you look at the eggplant, first meatball, cheese biscuit and zucchini dish recipes, I may update them in the style of the newly retyped recipes as above, while converting the texts of the newly retyped recipes to that format (the original format for my “personal cookbook”), and take photos.

Finally!  My recipes are now documented, accessible, shared, sharable, and, if I ever get around to it, ready for transfer into a “cookbook”.

FUDCon 2011 — lightning talks

Today at the lightning talks at FUDCon 2011, the one that caught my attention was called “The Dreyfus Model: how do novices think differently from experts?” The subtitle was along the lines of “Why won’t anyone help me, I have documentation!”  Here is a pdf archive of her talk I made at the time since as of at least 2020 or earlier, it disappeared.  20210425 update:  I have found a new link to Mel’s lightning talk at https://melchua.com/blog/2011/02/02/ive-followed-your-instructions-and-i-still-cant-bake-croissants/

The gist of how Mel presented the subject was that someone is looking for a bread recipe on the internet and comes up with:

Croissants

flour
butter
other stuff
bake

She explained the various cryptic parts of this “recipe” and how obvious it may seem to an experienced baker, but to a newbie, even figuring out that Croissants is a type of bread, let alone what the “other stuff” is can be difficult to grasp, or the concepts of “oh you have to buy those ingredients first — how much? And what’s this? You need an oven? Now, when they say bake, how long? And how will I know it’s ready? Oh yeah, you need to let the bread rise first …

She went on to say how installing certain bits of software and using them may seem trivial to an experienced user, but knowing how to draw in a tarball, extract it, get all the dependencies, compile it, and all the various steps required was not easy for a newbie, especially in a culture that takes several things for granted and literally may skip steps between major milestones.

Ultimately her message lay in the importance of clear, concise, complete documentation.

When I started learning linux, I had to relearn things too, and found things challenging. I quickly learned that things were not as obvious to myself and that when someone said “oh just do this” what they were really saying was “do this 10-15 item list as root under the following circumstances using the proper switches” — not always an obvious task when you say “install package X” while omitting all the necessary parts before and after.