katzen-cafe/iowo
2
4
Fork 1
Code Issues 4 Pull requests 2 Projects Releases Packages Wiki Activity

docs: some initial groundwork #2

Merged
multisamplednight merged 26 commits from :initial-docs into main 2024-01-20 19:00:52 +00:00
Conversation 25 Commits 26 Files changed 13 +13 -3
2 changed files with 13 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files
Showing only changes of commit 5f95f36214 - Show all commits

2
docs/design/iowo-design.typ
View file

@ -19,8 +19,6 @@
- algebraic enums - algebraic enums
- traits (`Numeric`...) - traits (`Numeric`...)
#pagebreak()
= Execution stages = Execution stages
multisamplednight marked this conversation as resolved Outdated
multisamplednight commented 2024-01-10 22:41:38 +00:00
Outdated
Review
Copy link

I really dislike using the word execution here, as it's a very common trigger word. Do you have any alternative ideas?

I **really** dislike using the word `execution` here, as it's a very common trigger word. Do you have any alternative ideas?
schrottkatze commented 2024-01-18 19:02:11 +00:00
Outdated
Review
Copy link

Parsing? Evaluation? Interpretation?

Parsing? Evaluation? Interpretation?
multisamplednight commented 2024-01-18 21:29:24 +00:00
Outdated
Review
Copy link

Those are all individual phases of execution.

Those are all individual phases of execution.
multisamplednight commented 2024-01-18 21:32:56 +00:00
Outdated
Review
Copy link

Hm. Thinking about it, Evaluation seems generic enough. I'll use that then.

Hm. Thinking about it, `Evaluation` seems generic enough. I'll use that then.
#graphics.stages-overview #graphics.stages-overview
multisamplednight marked this conversation as resolved Outdated
schrottkatze commented 2024-01-18 19:03:27 +00:00
Outdated
Review
Copy link

This is fine, probably something we can work on further as the project progresses though and it gets more complex...

This is fine, probably something we can work on further as the project progresses though and it gets more complex...

14
docs/template.typ
View file

@ -73,8 +73,10 @@
set text(..fonts.main) set text(..fonts.main)
set heading(numbering: "A.1") set heading(numbering: "A.1")
show link: text.with(fill: blue)
show heading: it => text(..fonts.heading, it) show heading: it => text(..fonts.heading, it)
// color links
show link: text.with(fill: blue)
// prettify codeblocks
show raw.where(block: true): box.with( show raw.where(block: true): box.with(
fill: luma(95%), fill: luma(95%),
inset: 1.25em, inset: 1.25em,
@ -93,6 +95,16 @@
it it
} }
// semi-strategically place pagebreaks for better orientation
let pagebreak-before(it) = pagebreak() + it
show heading.where(outlined: true): it => {
if it.level <= 2 {
pagebreak()
}
it
}
// highlight important terms in bold // highlight important terms in bold
show raw: it => { show raw: it => {
// avoid making terms in codeblocks bold // avoid making terms in codeblocks bold