Skip to content

Commit f3957f3

Browse files
docs: Clean redundancy in docs and typos.
1 parent 9893ccc commit f3957f3

3 files changed

Lines changed: 4 additions & 51 deletions

File tree

docs/pages/getting-started/quickstart.md

Lines changed: 2 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ In the browser, the runtime's `<edge-python>` element runs a `.py` file declarat
3939
</head>
4040
<body>
4141
<div id="app"></div>
42-
<edge-python entry="./app/hellp.py" packages="./app/packages.json"></edge-python>
42+
<edge-python entry="./app/hello.py" packages="./app/packages.json"></edge-python>
4343
</body>
4444
</html>
4545
```
@@ -65,58 +65,11 @@ Open the [playground](https://demo.edgepython.com) and try the SimplePerceptron
6565
greet = lambda name: f"Hello, {name}!"
6666

6767
for who in ["world", "edge", "python"]:
68-
print(greet(who))
68+
print(greet(who))
6969
```
7070

7171
```text Output
7272
Hello, world!
7373
Hello, edge!
7474
Hello, python!
7575
```
76-
77-
## Language overview
78-
79-
Edge Python is a Python subset with classes, async/await, structural pattern matching, and `packages.json` imports, compiled to bytecode and run on a sandboxed WebAssembly VM.
80-
81-
```python
82-
# First-class functions
83-
ops = [abs, len, str]
84-
print([f(-3) for f in ops])
85-
86-
# Currying with closures
87-
add = lambda x: lambda y: x + y
88-
print(add(3)(4))
89-
90-
# Pure functions are template-memoised after two hits with the same arguments (no decorators needed, this is detected by the VM)
91-
def fib(n):
92-
if n < 2: return n
93-
return fib(n - 1) + fib(n - 2)
94-
95-
print(fib(20))
96-
```
97-
98-
```text Output
99-
[3, 2, '-3']
100-
7
101-
6765
102-
```
103-
104-
## Next steps
105-
106-
<CardGroup cols={2}>
107-
<Card title="What it is" icon="compass" href="/getting-started/what-it-is">
108-
Scope, paradigm, and what intentionally isn't supported.
109-
</Card>
110-
<Card title="Syntax" icon="code" href="/language/syntax">
111-
Operators, literals, and the language surface.
112-
</Card>
113-
<Card title="Built-ins" icon="package" href="/reference/builtins">
114-
Every built-in function with examples and outputs.
115-
</Card>
116-
<Card title="Methods" icon="list" href="/reference/methods">
117-
String, list, and dict methods.
118-
</Card>
119-
<Card title="Packages" icon="boxes" href="/reference/packages">
120-
Ready-made modules: `json`, `dom`, `network`, `storage` and more.
121-
</Card>
122-
</CardGroup>

docs/pages/implementation/design.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Heap is a `Vec<HeapSlot>` arena with a free list (capped 524,288, sorted to pref
7373
- No IR, one representation between source and dispatch.
7474
- No JIT (single-tier, pure Rust). Method JITs need per-arch stencils; trace JITs duplicate the execution model and complicate GC.
7575
- No runtime module system, imports resolve at parse time through a host-injected `Resolver`. See [Imports](/reference/imports).
76-
- No bigints, complex numbers, `bytearray`, `memoryview`, `Decimal`, `Fraction`. No `gen.send` / `throw` / `close`. No `asyncio` module, `run`, `sleep`, `gather`, `with_timeout`, `cancel`, `receive` are top-level builtins.
76+
- No bigints, complex numbers, `bytearray`, `memoryview`, `Decimal`, `Fraction`. No `gen.send` / `throw` / `close`. No `asyncio` module — concurrency primitives are top-level builtins ([Async](/language/async)).
7777

7878
## Coroutine and context-manager dispatch
7979

docs/pages/reference/packages.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ print(dumps({"k": [1, 2, 3], "ok": True})) # {"k":[1,2,3],"ok":true}
3232

3333
Pre-built `.wasm` is served from `https://std.edgepython.com/json.wasm`. Full API: [`std/json/README.md`](https://github.com/dylan-sutton-chavez/edge-python/tree/main/std/json).
3434

35-
> **`json` is an external package, but the browser runtime resolves it by default.** It isn't compiled into `compiler_lib.wasm`, it's this `.wasm` package. In the browser runtime you can write `from json import ...` with no `packages.json` (a built-in [default](#defaults), fetched lazily on first import). Other hosts, or `defaults: false`, need it declared (alias or URL) like any other module.
35+
> **`json` is an external `.wasm` package, not built into `compiler_lib.wasm`**the browser runtime just resolves it by [default](#defaults), so `from json import ...` works with no manifest.
3636
3737
### `re`
3838

0 commit comments

Comments
 (0)