More docs

Author: mikera

docs/overview/manifesto.md

@@ -4,17 +4,17 @@ authors: [convex]
 tags: [convex, community, philosophy]
 ---
 
-# The Convex Manifesto - DRAFT
+# The Convex Manifesto (draft)
 
-We are building open economic systems based on decentralised technology for the 21st century and beyond.
+Building Open, Decentralized Economies for the 21st Century
 
-The time is ripe for change: For too long, our societies have been burdened by inefficient and unfair economic systems. Centralised organisations hold undue power, exploiting monopolistic control over most of our economic life. Transaction costs are massive, holding back progress and burdening people with unnecessary expenses. Many people are unfairly excluded from financial and economic participation. Our economic models are causing tragic and unsustainable damage to the natural world we all share.
+The time for change is now. For far too long, our societies have been shackled by inefficient and inequitable economic systems. Centralized institutions wield excessive power, exploiting monopolistic control over much of our economic activity. Transaction costs are exorbitant, hindering progress and imposing unnecessary burdens on individuals. Countless people are unfairly excluded from financial and economic participation. Our current economic models are inflicting irreversible damage on the natural world we all share.
 
-AI is rapidly changing the landscape of the digital economy, and indeed the whole world. At this critical time in our civilisation, it imperative that control over data, computational power and the economy as a whole is put back in the hands of individuals.
+Artificial intelligence is rapidly transforming the digital economy, and indeed, the entire world. At this pivotal moment in human history, it is imperative that control over data, computational power, and the economy as a whole is returned to the hands of individuals.
 
-Convex is a public decentralised system for real-time P2P exchange of data and value, designed as a substrate for the digital economy in the age of AI. As such, it provides the foundation for the type of economics we want to see in the world - fair, inclusive, efficient, diverse and sustainable.
+Convex is a public, decentralized system for real-time peer-to-peer exchange of data and value, designed as a foundational layer for the digital economy in the age of AI. As such, it provides the bedrock for the kind of economics we envision – fair, inclusive, efficient and sustainable.
 
-This manifesto outlines our beliefs and core principles.
+This manifesto outlines our core beliefs and principles.
 
 ## Open Economic Systems
 

papers/performance.md renamed to docs/overview/performance.md

@@ -1,4 +1,4 @@
-# Performance - Goals and how we do it
+# Performance
 
 Convex offers outstanding performance for decentralised applications. Our objective is to offer the best combination of decentralised security and interactive performance for applications in categories such as DeFi, gaming and the metaverse with large numbers of concurrent users.
 

docs/tutorial/convex-lisp/index.md

@@ -18,6 +18,7 @@ The CVM is designed to be able to support many different languages and paradigms
 
 Convex Lisp was heavily inspired by [Clojure](https://clojure.org/), from which it borrows most basic and many core functions, and [Racket Scheme](https://racket-lang.org/) which inspired many of the more advanced metaprograming facilities.
 
-## Some technical notes on Convex Lisp
+## Interesting technical notes
 
-- Convex Lisp is a **Lisp-1** (i.e. keeps function and data values in the same namespace).This is simpler than a Lisp-2 and seems more appropriate for a functional programming language, where functions are regularly treated as first class values.
+- Convex Lisp is a **Lisp-1** (i.e. keeps function and data values in the same namespace).This is simpler than a Lisp-2 and seems more appropriate for a functional programming language, where functions are regularly treated as first class values.
+- Convex Lisp is designed for **orthogonal persistence**. Developers don't need to care where data or code is stored: it is loaded and cached on demand. This powerful capability means that the CVM can operate code and data data structures much larger than system RAM without imposing any burden on developers.