Skip to content

Commit 56936a9

Browse files
committed
tweak docs
1 parent 2bd8d99 commit 56936a9

3 files changed

Lines changed: 14 additions & 7 deletions

File tree

pages/articles/ai-and-pointless/index.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,17 +26,17 @@ built. I think that generative AI could be helpful in this next phase of work.
2626

2727
As of March 2026, essentially all of the code in this project has been designed
2828
and written by hand, with the exception being very small code snippets (things
29-
like _"write a function to escape an HTML string in JS"_). Until now, there have been
30-
fewer than 100 lines of AI-generated code in this project across the core
29+
like _"write a function to escape an HTML string in JS"_). Until now, there have
30+
been fewer than 100 lines of AI-generated code in this project across the core
3131
language code, standard library implementation, documentation, tooling, and
3232
website. Any AI-generated code that is currently present was not added using
3333
agentic AI, but was instead manually reviewed and incorporated into the project.
3434

3535
I myself started using AI regularly about a year ago, slowly incorporating it
3636
into my work. Over the past six months, when working on this project, I've used
37-
generative AI to help me understand APIs and
38-
specifications of existing software, and get feedback on design decisions.
39-
Examples of questions I've asked AI include:
37+
generative AI to help me understand APIs and specifications of existing
38+
software, and get feedback on design decisions. Examples of questions I've asked
39+
AI include:
4040

4141
- What is the difference between `AbortController` and `AbortSignal`?
4242
- What are valid characters in an ISO 8601 string?
@@ -70,8 +70,11 @@ like:
7070
list of topics I want to cover I might ask AI for suggestions on the best
7171
order in which to cover them.
7272

73-
- I won't use AI to write any of the core language code (the code in
74-
[pointless/lang](https://github.com/pointless-lang/pointless/tree/main/lang)).
73+
- I won't use AI to write any of the core language or standard library code
74+
(the code in
75+
[pointless/lang](https://github.com/pointless-lang/pointless/tree/main/lang)
76+
and
77+
[pointless/stdlib](https://github.com/pointless-lang/pointless/tree/main/stdlib))).
7578
I know this code like the back of my hand and I want it to stay this way. If I
7679
ever decide to overhaul the language implementation (have it compile to WASM,
7780
say) then I might revisit this decision.

pages/language/conditionals/index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,7 @@ parity = match n % 2
146146
end
147147
```
148148

149+
<!--
149150
## Match without Else
150151
151152
`match` expressions don't need to have `else` branches. If none of the `case`
@@ -161,6 +162,7 @@ parity = match n % 2
161162
case 1 then "odd"
162163
end
163164
```
165+
-->
164166

165167
## Multi-Option Cases
166168

pages/language/misc/index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ values, including:
3535
which contains no code, or whose [final statement](misc#final-statement-value)
3636
is not an expression.
3737

38+
<!--
3839
- Evaluating an `if` or `match` expression with no matching branch and no `else`
3940
branch.
4041
@@ -49,6 +50,7 @@ values, including:
4950
case 0 then "even"
5051
end
5152
```
53+
-->
5254

5355
- Calling a function, evaluating a conditional branch, or importing a script
5456
which contains no code.

0 commit comments

Comments
 (0)