docs: some initial groundwork #2

Merged
multisamplednight merged 26 commits from :initial-docs into main 2024-01-20 19:00:52 +00:00
4 changed files with 31 additions and 41 deletions
Showing only changes of commit ec3d1310bf - Show all commits

1
.envrc
View file

@ -1 +1,2 @@
use flake . --impure use flake . --impure
export TYPST_ROOT="$(pwd)/docs"

View file

@ -3,7 +3,6 @@ The current maintainers, that is,
- [@Schrottkatze](https://forge.katzen.cafe/schrottkatze) - [@Schrottkatze](https://forge.katzen.cafe/schrottkatze)
- [@multisamplednight](https://forge.katzen.cafe/multisamplednight) - [@multisamplednight](https://forge.katzen.cafe/multisamplednight)
- @iota-xSK
multisamplednight marked this conversation as resolved Outdated

Remove her, as she stated to me that she does not want to be listed there and is not sure whether she wants to be an active maintainer.

Remove her, as she stated to me that she does not want to be listed there and is not sure whether she wants to be an active maintainer.
are the entities to email, message or talk to if you feel like any interaction in the context of are the entities to email, message or talk to if you feel like any interaction in the context of
iOwO is not okay. We'll try to answer as soon as we can. iOwO is not okay. We'll try to answer as soon as we can.

View file

@ -4,35 +4,35 @@ Before we get started, thank you for thinking about doing so!
## Through an issue ## Through an issue
- Be excellent to each other. Adhere to the [code of conduct]. - Be excellent to each other. Adhere to the [code of conduct]
- About the title: If you had 5 seconds to tell someone the essence of the issue, what would it be? - About the title: If you had 5 seconds to tell someone the essence of the issue, what would it be?
### Bugs ### Bugs
- Write out in detail which steps in which order are necessary to reproduce the bug. - Write out in detail which steps in which order are necessary to reproduce the bug
- Include environmental information as well, in specific - Include environmental information as well, in specific
- How did you install iOwO? - How did you install iOwO?
- What version of iOwO are you running? - What version of iOwO are you running?
- What operating system are you running? - What operating system are you running?
In the case of a Linux distro, mention the specific distro and when you last update as well. In the case of a Linux distro, mention the specific distro and when you last update as well
- If the bug causes a crash, try to get a backtrace or in worse cases, a coredump. - If the bug causes a crash, try to get a backtrace or in worse cases, a coredump
### Feature requests ### Feature requests
- Be sure to include a motivation in which case your intended feature would be used, - Be sure to include a motivation in which case your intended feature would be used
even if it seems obvious to you. even if it seems obvious to you
- Estimate what would be needed to implement the feature. - Estimate what would be needed to implement the feature
multisamplednight marked this conversation as resolved Outdated

Maybe replace the dot with a colon, that feels more correct due to the following enumeration

Maybe replace the dot with a colon, that feels more correct due to the following enumeration

Tbh then I'd rather completely remove the dots at the end, would that be fine, too?

Tbh then I'd rather completely remove the dots at the end, would that be fine, too?

I meant specifically in the last thingy, like this:

- Estimate what would be needed to implement the feature:
  - Is it an addition to the language itself?
  - Is it just a new command?
  - Does it ground-breakingly change how iOwO works?
I meant specifically in the last thingy, like this: ``` - Estimate what would be needed to implement the feature: - Is it an addition to the language itself? - Is it just a new command? - Does it ground-breakingly change how iOwO works? ```
- Is it an addition to the language itself? - Is it an addition to the language itself?
- Is it just a new command? - Is it just a new command?
- Does it ground-breakingly change how iOwO works? - Does it ground-breakingly change how iOwO works?
## Through a PR ## Through a PR
1. Clone the repo. 1. Clone the repo
2. Switch to a new appropiately named branch for what you want to do, using `git switch -c`. 2. Switch to a new appropiately named branch for what you want to do, using `git switch -c`
3. Implement your code changes with your favorite code editor. 3. Implement your code changes with your favorite code editor
4. Try them with `cargo run`. 4. Try them with `cargo run`
5. If there are errors or warnings, go to step 3. Commit occasionally. 5. If there are errors or warnings, go to step 3. Commit occasionally
6. Otherwise, 6. Otherwise,
- if you have an account at https://forge.katzen.cafe, - if you have an account at https://forge.katzen.cafe,
1. fork the repo 1. fork the repo
@ -42,6 +42,8 @@ Before we get started, thank you for thinking about doing so!
1. combine your patches using `git diff --patch` and throw them in a file 1. combine your patches using `git diff --patch` and throw them in a file
2. send that file to one of the maintainers per email 2. send that file to one of the maintainers per email
- alongside with a description of what it does - alongside with a description of what it does
multisamplednight marked this conversation as resolved Outdated

thing for the future: potential both way mirrors if that's possible? so we can accept contributions from gitlab and github...

thing for the future: potential both way mirrors if that's possible? so we can accept contributions from gitlab and github...
3. also mention in the mail that we should consider GitHub and GitLab mirrors,
referring to this line
### Tech stack ### Tech stack
@ -68,28 +70,28 @@ If you want to contribute art or the like, do that in whatever **you** are most
## Politics ## Politics
- Current maintainers are defined as the entities listed in the [code of conduct]. - Current maintainers are defined as the entities listed in the [code of conduct]
### PRs ### PRs
- Every PR requires an approving review from a maintainer (that is not the author) before merge. - Every PR requires an approving review from a maintainer (that is not the author) before merge
- Maintainers can merge their own PRs. - Maintainers can merge their own PRs
- But only after approval. - But only after approval
### Major decisions ### Major decisions
- All current maintainers have to agree **unanimously**. - All current maintainers have to agree **unanimously**
- Agreement must be based on [informed consent]. - Agreement must be based on [informed consent]
- In effect, a maintainer has to understand what they agree to. - In effect, a maintainer has to understand what they agree to
# Interacting with PRs # Interacting with PRs
multisamplednight marked this conversation as resolved Outdated

is this supposed to render a certain way? it just shows the [!NOTE] when rendered

is this supposed to render a certain way? it just shows the `[!NOTE]` when rendered

It does in some markdown viewers such as Obsidian or GitHub, but apparently not on Forgejo. I'll remove it then.

It does in some markdown viewers such as Obsidian or GitHub, but apparently not on Forgejo. I'll remove it then.
> [!NOTE] Remember, be respectful. Remember, be respectful.
> Entities invest their free time and motivation into making these changes, Entities invest their free time and motivation into making these changes,
> treat them appropiately. treat them appropiately.
- Since in iOwO, we mostly work based on forks, [git's remotes] work fairly good. - Since in iOwO, we mostly work based on forks, [git's remotes] work fairly good
- Replace things in pointy brackets (`<>`) respectively (and remove the pointy brackets). - Replace things in pointy brackets (`<>`) respectively (and remove the pointy brackets)
## Initial steps for a new contributor or new local checkout ## Initial steps for a new contributor or new local checkout
multisamplednight marked this conversation as resolved Outdated

that reads a bit weird to me, maybe rephrase to:

-- Since in iOwO, we mostly work based on forks, [git's remotes] work fairly good.
+- Since we mostly work using forks, [git's remotes] work fairly well.
that reads a bit weird to me, maybe rephrase to: ```diff -- Since in iOwO, we mostly work based on forks, [git's remotes] work fairly good. +- Since we mostly work using forks, [git's remotes] work fairly well. ```
@ -100,8 +102,8 @@ git remote update <contributor-name>
## After setting up the remote ## After setting up the remote
multisamplednight marked this conversation as resolved Outdated

Forgejo with a capital F since this is a document (so ig spelling is important) and forgejo is a name mew

Forgejo with a capital F since this is a document (so ig spelling is important) and forgejo is a name mew
- You can repeat this step anytime you want to switch branches or update your local checkout. - You can repeat this step anytime you want to switch branches or update your local checkout
- The PR branch is visible just below the PR title on forgejo, after the colon (`:`). - The PR branch is visible just below the PR title on Forgejo, after the colon (`:`)
```sh ```sh
git switch <pr-branch> git switch <pr-branch>

View file

@ -7,19 +7,7 @@
subtitle: [don't worry, we're just dreaming], subtitle: [don't worry, we're just dreaming],
) )
= Type data model = Evaluation stages
multisamplednight marked this conversation as resolved Outdated

I think we should remove this entire section from this document for now, since I'm working on this in a different document

I think we should remove this entire section from this document for now, since I'm working on this in a different document
== Requirements
- Color-aware
- It can handle colors and colorspaces for images
- OpenColorIO?
- number/number type support
- custom types (structs/enums)
- algebraic enums
- traits (`Numeric`...)
= Execution stages
#graphics.stages-overview #graphics.stages-overview