reorg

adoc/code-mage/back/behind-the-curtain/index.adoc

@@ -1,4 +1,4 @@
-= Behind the curtain
+= Appendix: Behind the curtain
 
 Welcome to "Behind the curtain," where we reveal the intricate mechanics powering the magic powering Code-Mage spells like `cm init` and `cm work`. This section is for the curious, the builders, and those who want to understand and take control of their tools. Here, you'll learn how to set up everything manually, step by step. While this might seem like "the hard way," it’s also the most illuminating. It comes at the back of the book because really you shouldn't worry about this stuff until you have at least gained some mastery of coding. Whether you’re here out of curiosity or necessity, this journey will deepen your understanding of the magic that makes it all possible.
 

adoc/code-mage/front/preface/whats-in-this-book.adoc

@@ -6,7 +6,7 @@ This book is focused on learning to code in Go from the terminal command line an
 
 This book is divided into four main parts:
 
-. **Introduction**: Understand what coding means
+. **Understand**: Know what coding and computer science are
 . **Prepare**: Get everything ready and master coding prerequisites
 . **Learn**: Code memorable micro-projects based on concepts
 . **Create**: Develop something useful that you want

adoc/code-mage/main/create/index.adoc

@@ -1,5 +1,4 @@
 = Create applications
-The path of the code mage: from learning to mastery
 
 Many embark on the journey of learning to code through small, contrived examples—simple spells to grasp the fundamentals. But true magic lies beyond these first incantations, in crafting real-world applications that solve meaningful problems for real people. To transition from student to creator is to embrace the challenges of building tools, systems, and experiences that resonate with others and leave a lasting impact.
 

adoc/code-mage/main/index.adoc

@@ -1,6 +1,6 @@
-include::intro/index.adoc[]
+include::understand/index.adoc[]
 
-include::prep/index.adoc[]
+include::prepare/index.adoc[]
 
 include::learn/index.adoc[]
 

adoc/code-mage/main/prep/install-pde.adoc → adoc/code-mage/main/prepare/install-pde.adoc

@@ -5,7 +5,7 @@ Every great mage has their sanctum, a personal development environment (PDE) whe
 
 This section shows how to install all the components of your PDE with Code-Mage assistant—transforming your computer into a professional coder workstation with just one command—and then summarizes the components that were installed and configured for you so you can understand what happened. In fact, you can customize these later on your own. Everything that the Code-Mage assistant does is well explained in the <<behind-the-curtain, Behind the Curtain>> section at the end of the book.
 
-=== Download and install rwxrob-books
+=== Install rwxrob-books
 
 [CAUTION]
 ====

adoc/code-mage/main/intro/index.adoc → adoc/code-mage/main/understand/index.adoc

@@ -1,11 +1,11 @@
-= Introduction
+= Understand coding
 
-Welcome to the magical world of coding! This book will help you learn programming concepts through memorable spells and cantrips which you can add to your own tome of coding magic, or _code book_, a digital notebook containing runnable code.
+Welcome to the magical world of coding! This book will help you learn programming concepts through memorable spells and cantrips which you can add to your own tome of coding magic, or _code book_, a digital notebook containing runnable code. But first its important to know what coding and computer science are and why they matter and get some idea of what life as a code mage is like to help you decide up front if this is something worth your time.
 
 include::why-code.adoc[]
 
-include::mage-life.adoc[]
-
 include::what-it-takes.adoc[]
 
+include::mage-life.adoc[]
+
 include::why-go.adoc[]