mchapman/the-sourdough-framework
1
0
Fork 0
mirror of https://github.com/hendricius/the-sourdough-framework synced 2025-11-09 04:31:11 -06:00
Code Issues Actions Packages Projects Releases Wiki Activity

Restructure preface into logical paragraphs (#192)

Browse Source 
Plus some very small changes in the text
This commit is contained in:
cedounet
2023-08-24 08:43:15 +01:00
committed by GitHub
parent 40d37f0df6
commit c563477773
3 changed files with 20 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
book/book.tex
View File

@@ -16,10 +16,8 @@
% \tableofcontents % \tableofcontents
\ifdefined\HCode\else\tableofcontents\fi \ifdefined\HCode\else\tableofcontents\fi
\chapter{Foreword}
\input{intro/foreword} \input{intro/foreword}
\chapter{Preface}
\input{intro/preface} \input{intro/preface}
\chapter{Acknowledgements} \chapter{Acknowledgements}

4
book/intro/foreword.tex
View File

@@ -1,2 +1,4 @@
\chapter{Foreword}%
\label{ch:Foreword}
Hopefully one day there is going to be an awesome foreword Hopefully one day there is going to be an awesome foreword
by another bread baker! by another bread baker!

37
book/intro/preface.tex
View File

@@ -1,3 +1,6 @@
\chapter{Preface}%
\label{ch:Preface}
If there is one food Germany is known for, it is probably bread. If there is one food Germany is known for, it is probably bread.
There are thousands of varieties in Germany, There are thousands of varieties in Germany,
and making it has been an integral part of our culture. and making it has been an integral part of our culture.
@@ -9,7 +12,7 @@ Being a bit more experienced, I~now realize it's
ideal to wait a little while before cutting into your bread, but back then, ideal to wait a little while before cutting into your bread, but back then,
we kids couldn't wait. Mom would cut for us a few slices straight from the oven, and we would we kids couldn't wait. Mom would cut for us a few slices straight from the oven, and we would
immediately proceed to pour butter or jam on each slice. Within minutes, immediately proceed to pour butter or jam on each slice. Within minutes,
\qty{1}{\kg} of flour would be consumed. Bread became an integral part of my one kilogram of flour would be consumed. Bread became an integral part of my
weekly food. weekly food.
I~was lucky that my parents could afford a yearly ski trip to I~was lucky that my parents could afford a yearly ski trip to
@@ -32,18 +35,18 @@ to get close to the experience we had while on vacation.
Some years passed, and I~eventually began my studies in the small German city of Göttingen. Some years passed, and I~eventually began my studies in the small German city of Göttingen.
For the first time, I~was faced with shopping for my own bread. It was never For the first time, I~was faced with shopping for my own bread. It was never
on my mind to actually start baking it for myself. I~would just buy on my mind to actually start baking it for myself. I~would just buy
a good loaf while shopping at the supermarket. My favorite variety a good loaf while shopping at the supermarket. My favorite variety
was a \emph{Schwarzbrot: Korn an Korn}. It’s a very dark and hearty rye bread was a \emph{Schwarzbrot: Korn an Korn}. It’s a very dark and hearty rye bread
with added berries and sunflower seeds. Being a little naïve, with added berries and sunflower seeds.
I'd never before examined the packaging of what I~was buying. One day, that
changed.
I~looked at the label and was shocked. The seemingly Being a little naïve, I'd never before examined the packaging of what I~was
buying. One day, that changed. I~looked at the label and was shocked. The
seemingly
healthy bread consisted of so many other things aside from flour and water. healthy bread consisted of so many other things aside from flour and water.
The black color was not coming from the flour, but from caramelized sugar. The black color was not coming from the flour, but from caramelized sugar.
The packaging stated it was a sourdough bread, but then why was there additional yeast? The packaging stated it was a sourdough bread, but then why was there additional yeast?
I~thought that if it was really sourdough, it shouldn't require additional yeast, and I~soon I~thought that if it was really sourdough, it shouldn't require additional yeast, and I~soon
realized that something was wrong with the bread I~was buying. realized that something was wrong with the bread I~was buying.
I~proceeded to check the other supermarket breads, only to discover that they, too, I~proceeded to check the other supermarket breads, only to discover that they, too,
contained ingredients I'd never heard of. That was the day I~lost trust contained ingredients I'd never heard of. That was the day I~lost trust
@@ -54,11 +57,11 @@ I~learned that the recipes for making pizza and bread were actually quite simila
there were also differences. For example, some recipes would call for fresh yeast, while there were also differences. For example, some recipes would call for fresh yeast, while
others would call for dry. Diving deep into various online forums and all their many others would call for dry. Diving deep into various online forums and all their many
discussions, I~became even more confused. discussions, I~became even more confused.
I~tried using different flours and different brands, all in both organic and non-organic varieties. I~tried using different flours and different brands, all in both organic and non-organic varieties.
I~realized then that I~knew nothing about making bread. Recipes would often contradict each other, I~realized then that I~knew nothing about making bread. Recipes would often contradict each other,
leaving me further confused. They seemed like little more than a collection of apparently random leaving me further confused. They seemed like little more than a collection of apparently random
steps to follow. The baking instructions and temperatures were all different, too. steps to follow. The baking instructions and temperatures too were all
different\dots
Meanwhile, having completed my studies, I~started work as an engineer. Meanwhile, having completed my studies, I~started work as an engineer.
We engineers are faced with many challenges. The compiler or runtime is We engineers are faced with many challenges. The compiler or runtime is
@@ -72,7 +75,6 @@ This pre-written code is commonly known as \emph{a framework}. In many cases,
these frameworks are not built by a single person but by engineers from all around the world, these frameworks are not built by a single person but by engineers from all around the world,
each of whom can help by improving and changing the source code. Frameworks have made many successful each of whom can help by improving and changing the source code. Frameworks have made many successful
businesses possible. businesses possible.
In most cases, frameworks do exactly what they claim they do. However, In most cases, frameworks do exactly what they claim they do. However,
sometimes you are faced with issues you don't understand. In \qty{99.95}{\percent} sometimes you are faced with issues you don't understand. In \qty{99.95}{\percent}
of all software bugs, the developer is the issue. Sometimes, however, the framework has a of all software bugs, the developer is the issue. Sometimes, however, the framework has a
@@ -89,11 +91,10 @@ should I~slap my dough while kneading it on the counter? Why is a standmixer
better than kneading by hand? Why should I~let the dough sit for this long? better than kneading by hand? Why should I~let the dough sit for this long?
Why is steaming the dough during baking important? Do I~really need to Why is steaming the dough during baking important? Do I~really need to
get myself an expensive Dutch oven to bake bread? get myself an expensive Dutch oven to bake bread?
The problem compounded when I~started reading about sourdough. It all sounded like black The problem compounded when I~started reading about sourdough. It all sounded like black
magic. Why were some sourdoughs made from fruits, while others were made from flour? magic. Why were some sourdoughs made from fruits, while others were made from flour?
Why should one recipe use wheat while another used rye or spelt? How often should the Why should one recipe use wheat while another used rye or spelt? How often should the
sourdough be fed? The questions I~had then could have filled 20 pages. I~was confused, sourdough be fed? The questions I~had then could have filled 20~pages. I~was confused,
but I~became even more determined to learn how decent bread should be made at home. but I~became even more determined to learn how decent bread should be made at home.
The feedback I~received from friends helped me to improve with each The feedback I~received from friends helped me to improve with each
@@ -108,8 +109,7 @@ I~continued learning about the process of fermentation and various techniques of
I~approached the topic of sourdough in a manner similar to software, and after years of I~approached the topic of sourdough in a manner similar to software, and after years of
researching and documenting my progress, I~decided it was time to share that progress with the researching and documenting my progress, I~decided it was time to share that progress with the
world. world.
When working on software projects, it is important to see their history and how the source
When working on open source projects, it is important to see their history and how the source
code changes over time. This way, you can easily jump back to previous versions. This was code changes over time. This way, you can easily jump back to previous versions. This was
the perfect tool for documenting my recipes, because they, too, would change with each the perfect tool for documenting my recipes, because they, too, would change with each
subsequent iteration. Much to my surprise, my open source work on sourdough was appreciated subsequent iteration. Much to my surprise, my open source work on sourdough was appreciated
@@ -119,10 +119,9 @@ share open source software.
Now, when baking great bread, you also need to learn certain techniques. I~figured it would be Now, when baking great bread, you also need to learn certain techniques. I~figured it would be
easier to share these techniques in video form. Thus, my YouTube channel was born. I~chose easier to share these techniques in video form. Thus, my YouTube channel was born. I~chose
the name \texttt{The Bread Code} to capture my engineering-oriented approach to bread. It took some the name \texttt{The Bread Code} to capture my engineering-oriented approach to bread. It took some
time to get right, but after choosing more engaging thumbnails and titles for time to get it right, but after choosing more engaging thumbnails and titles for
the videos I~made, the channel started gaining viewers. the videos I~made, the channel started gaining viewers.
Finally, three years later, I~dedicate two days each week to follow my bread baking passion, while
Now, three years later, I~dedicate two days each week to follow my bread baking passion, while
the other three days I~continue to work as a software engineer, writing code on a day-to-day the other three days I~continue to work as a software engineer, writing code on a day-to-day
basis. basis.
@@ -134,7 +133,7 @@ scratching the surface with what I~know and teach. Would you ever have imagined
flies are like bees and are part of the wild yeast's success story? I~made a video where flies are like bees and are part of the wild yeast's success story? I~made a video where
I~tried to cultivate wild yeast spores coming from fruit flies in order I~tried to cultivate wild yeast spores coming from fruit flies in order
to bake bread. It worked; the bread turned out amazingly well and even tasted good! These kinds of to bake bread. It worked; the bread turned out amazingly well and even tasted good! These kinds of
experiments spark my natural interest. Conducting them and seeing how other people share in my experiments spark my natural interest. Conducting them and seeing how other people share my
interest makes me incredibly happy. interest makes me incredibly happy.
The problem with running a YouTube channel is that all the information The problem with running a YouTube channel is that all the information
@@ -156,13 +155,11 @@ German. After discussions with members of the community, I~figured that writing
help me achieve that goal. Most of the books that exist today are collections of recipes. My help me achieve that goal. Most of the books that exist today are collections of recipes. My
idea, however, is to provide you with a deeper foundation of knowledge that you can use to idea, however, is to provide you with a deeper foundation of knowledge that you can use to
follow other recipes. follow other recipes.
In software terms, this would be a \emph{bread framework}. In software terms, this would be a \emph{bread framework}.
It is my goal for this book to help everyone facing issues with flour, fermentation, baking, It is my goal for this book to help everyone facing issues with flour, fermentation, baking,
and more. It should provide a detailed understanding as to why certain steps are necessary and more. It should provide a detailed understanding as to why certain steps are necessary
and how to adapt them when things go wrong while making bread. and how to adapt them when things go wrong while making bread.
It is my desire for this knowledge to be accessible to everyone around the world, regardless It is my desire for this knowledge to be accessible to everyone around the world, regardless
of budget, and as such, I~do not want to charge for the book. That's why I've decided to make of budget, and as such, I~do not want to charge for the book. That's why I've decided to make
it open source and have asked the community to support my work financially via my ko-fi page it open source and have asked the community to support my work financially via my ko-fi page