Direct Knowledge
Preface
Currently, this is the (working) first draft of the upcoming book Direct Knowledge: On the theory of connections, concepts, and geometry, to be available on Amazon. Both paperback and hardcover will be available soon.
Writing Philosophy
To be a successful writer, according to Halmos (1970), you must possess an inherent confidence and have something to say. You also need the capacity to think critically (and creatively) in order to create powerful arguments when conveying ideas; these are key elements necessary for writing mathematics clearly and effectively. For more on this, read Knuth et al. (1989).
Writing mathematics is an artful combination of two distinct languages, natural and mathematics. Natural language offers the writer numerous expression possibilities, but can be ambiguous. In contrast, writing with mathematical symbols requires clarity yet allows succinctness when conveying complex concepts. Accurate language is a necessity when it comes to mathematics. To comprehend mathematically expressed ideas, readers must take their time and read the content several times, while allowing themselves ample pauses for contemplation along the way. Further, mathematics writing often serves as reference material, which necessitates that its contents should ideally be accessed piece by piece upon demand rather than require deep immersion into text volumes at once.
Writing mathematics has rules – some narrow, others broad. Small conventions relate to sentence structure (including punctuation) and are easily verifiable. Broader ones involve general style and strategies that depend on the author’s discretion. For a full primer on mathematical writing, see Krantz (2017).
Crafting an effective book takes more than just following a few simple rules; it requires mastering composition. This skillfulness is where the art of writing comes in, with broad and deep strategies for your entire work. It’s all about connection: linking individual sentences together for clarity and flow while adhering to specific sentence structure regulations like commas or mathematical terminologies. At its most complex level, these interrelated requirements can create intricate webs that are both precise yet engaging – and (if followed) can result in a masterpiece.
Acknowledgments
Here’s a brief explanation of which technologies I used to write this book. I use Visual Studio Code to write in HTML, CSS, JS, Markdown, Quarto Markdown, Python, and TeX. After setting up a few configuration files, I issue the command “quarto render” to build the files. The website, book, and slides are outputs from this building process. Math is displayed on the webpages using MathJax, Python runs in the browser using PyScript, and the PDFs (hardcover and paperback) are created using an installation of LaTeX in the background via Pandoc. These files are uploaded to a GitHub repository and then published using Netlify. I then use the ReavalJS slideshows to make YouTube videos. I have found that this process takes place very quickly and is without cost.
This book wouldn’t have been possible without those special developers who offered their time and devotion to their software. I am profoundly grateful to them for supporting everyone’s work, and in particular mine.
Finally, I would like to thank my wife, Sally, for her love, support, and understanding while I wrote this book.
David A. Smith
Fort Worth, Texas
Other Resources
This book is paired with my YouTube channel where I discuss the main ideas in this book. These videos can be found here on this site as video embeds, so you can read, write, and watch all in one place.
Update History
Here is where I keep a log of the majors changes as I finish writing the book.
- First draft of preface published on 3/03/2023.
- First draft published on 3/04/2023.