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/_index.md
+16-9Lines changed: 16 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,6 +14,8 @@ I am excited to announce the release of [**cgp-serde**](/blog/cgp-serde-release/
14
14
15
15
[Read the announcement blog post](/blog/cgp-serde-release/) to find out more.
16
16
17
+
---
18
+
17
19
# Quick Introduction
18
20
19
21
Context-Generic Programming (CGP) is a modular programming paradigm that enables you to bypass the **coherence restrictions** in Rust traits, allowing for **overlapping** and **orphan** implementations of any CGP trait.
@@ -49,32 +51,37 @@ delegate_components! {
49
51
50
52
In this example, `MyData` implements the `Hash` trait by using `delegate_components!` to delegate its implementation to the `HashWithDisplay` provider, identified by the key `HashProviderComponent`. Because `MyData` already implements `Display`, the `Hash` trait is now automatically implemented through CGP via this delegation.
51
53
54
+
---
55
+
52
56
# Current Status
53
57
54
-
As of 2025, CGP remains in its _early stages_of development. While promising, it still has several rough edges, particularly in areas such as documentation, tooling, debugging techniques, community support, and ecosystem maturity.
58
+
As of 2025, it is important to note that CGP remains in its **formative, early stages**of active development. While the potential is genuinely promising, it still has several inevitable rough edges, particularly in key areas such as comprehensive documentation, mature tooling, streamlined debugging techniques, robust community support, and overall ecosystem maturity.
55
59
56
-
As such, adopting CGP for serious projects comes with inherent challenges, and you are advised to proceed _at your own risk_. The primary risk is not technical but stems from the limited support available when encountering difficulties in learning or applying CGP.
60
+
Consequently, embracing CGP for your mission-critical, serious projects comes with inherent challenges, and you should be advised to proceed **at your own discretion and risk**. The primary risk you face is not strictly technical, but rather stems from the current limited support available when you inevitably encounter difficulties while learning or attempting to apply CGP in production.
57
61
58
-
At this stage, CGP is best suited for early adopters and potential [contributors](/overview/#contribution) who are willing to experiment and help shape its future.
62
+
At this pioneering stage, CGP is an ideal fit for [**early adopters and enthusiastic potential contributors**](/contribute/) who are eager to experiment with the paradigm and actively help to shape its powerful future.
63
+
64
+
---
59
65
60
66
# Getting Started
61
67
62
-
Even though CGP is officially still less than one year old, some of the documentation and resources available already become outdated, or get obsoleted by more intuitive patterns. Nevertheless, this section attempts to provide you with the best guidance on how to learn more about CGP.
68
+
Even though the CGP project is officially still less than one year old, some of the initial documentation and resources you might find have already become slightly outdated, or they have been gracefully superseded by more intuitive and modern patterns. Nevertheless, this section is an attempt to provide you with the very best and most current guidance on how you can effectively begin to learn more about CGP.
63
69
64
70
## Blog Posts
65
71
66
-
The most up-to-date resources about CGP is available in the form of [blog posts](/blog). In particular, the blog posts from [v0.6.0 onward](/blog/v0-6-0-release/) give a more concise explanation of what CGP is about.
72
+
The most accurate and up-to-date resources concerning CGP are currently available in the form of our insightful [blog posts](/blog). Specifically, we recommend that the blog posts starting from the [**v0.6.0 release onward**](/blog/v0-6-0-release/) will give you a significantly more concise and modern explanation of precisely what CGP is all about.
67
73
68
74
## Hello World Tutorial
69
75
70
-
The [Hello World Tutorial](/tutorials/hello)gives a highlevel walkthrough of various CGP features using a hello-world style example.
76
+
The hands-on [Hello World Tutorial](/tutorials/hello)provides a high-level and clear walkthrough of various fundamental CGP features by using a familiar, simple hello-world style example.
71
77
72
78
## Book
73
79
74
-
If you would like to understand CGP from first principles, without relying on the [`cgp` crate](https://github.com/contextgeneric/cgp), the best approach is to dive into our book, [Context-Generic Programming Patterns](https://patterns.contextgeneric.dev/). It provides a comprehensive guide to understanding the inner working CGP.
75
80
76
-
Note that the book has not been updated for a while, and you might want to skip the book if you only want to start using CGP quickly with minimal learning curve!
81
+
If your preference is to rigorously understand CGP from its **first principles**, without relying on the specific implementations within the [`cgp` crate](https://github.com/contextgeneric/cgp), your best approach is to dive into our comprehensive book, [Context-Generic Programming Patterns](https://patterns.contextgeneric.dev/). This resource provides a deep, thorough guide to understanding the complex inner workings of CGP.
82
+
83
+
Please note that this book has not been updated for a while, and you might consider skipping the book entirely if your primary goal is to start using CGP quickly with the absolute minimal learning curve!
77
84
78
85
## Resources
79
86
80
-
Check out the [Resources](/resources) page for more materials and learning tools to help you get up to speed with CGP.
87
+
Make sure to check out the dedicated [Resources](/resources) page, which contains more supplementary materials and various learning tools to help you get up to speed with CGP.
0 commit comments