You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/introduction.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,17 +45,17 @@ useful design patterns that can be used in any programming situation.
45
45
This book is currently a work in progress. A majority of the chapter is yet to be written.
46
46
Please come back later to check out a completed version of this book.
47
47
48
-
## Scope of This Book
48
+
## Whom is This Book For
49
49
50
-
This book is written in the style of a reference material for readers with all levels of expertise.
51
-
As a result, it may not be as easy to understand for beginners who need a little more introduction
52
-
to more basic programming techniques in Rust.
50
+
This book tries to explain how CGP works by building the majority of its constructs from the ground up. However, many of the explained concepts are not immediately useful for writing CGP code, in particularly at the beginner level. This is because CGP already provides high enough abstraction, that one can write highly productive CGP code without understanding all the underlying details.
53
51
54
-
A separate book will be written in the future, to provide beginner-friendly tutorials for learning context-generic programming.
52
+
<divclass="warning">
53
+
Because of the above reasons, _you may not benefit much from reading this book_ if your goal is to get started with writing CGP as soon as possible.
54
+
</div>
55
55
56
-
For brievity, this book also does not cover motivation or concrete examples of _why_ you should
57
-
learn and use context-generic programming. We will cover that in blog posts, and a separate book
58
-
that covers real world use of CGP.
56
+
On the other hand, the book is mainly useful for those who wish to understand better what happens behind the macros, after they have started using CGP for some time. This book would also be useful for users to understand better on what went wrong when encountering CGP-related error messages, so that they can fix the errors more effectively.
57
+
58
+
A separate book will be written in the future, to provide beginner-friendly tutorials for getting started with CGP more quickly.
59
59
60
60
## Chapter Outlines
61
61
@@ -81,4 +81,4 @@ Anyone is welcome to contribute by submitting [pull requests](https://github.com
81
81
for grammatical correction, content improvement, or adding new design patterns.
82
82
83
83
A [GitHub Discussions](https://github.com/contextgeneric/cgp-patterns/discussions) forum is available for readers
84
-
to ask questions or have discussions for topics covered in this book.
84
+
to ask questions or have discussions for topics covered in this book.
0 commit comments