Skip to content

Commit 8544c38

Browse files
committed
Revise introduction
1 parent 726e01d commit 8544c38

1 file changed

Lines changed: 9 additions & 9 deletions

File tree

content/introduction.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -45,17 +45,17 @@ useful design patterns that can be used in any programming situation.
4545
This book is currently a work in progress. A majority of the chapter is yet to be written.
4646
Please come back later to check out a completed version of this book.
4747

48-
## Scope of This Book
48+
## Whom is This Book For
4949

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.
5351

54-
A separate book will be written in the future, to provide beginner-friendly tutorials for learning context-generic programming.
52+
<div class="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>
5555

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.
5959

6060
## Chapter Outlines
6161

@@ -81,4 +81,4 @@ Anyone is welcome to contribute by submitting [pull requests](https://github.com
8181
for grammatical correction, content improvement, or adding new design patterns.
8282

8383
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

Comments
 (0)