Update build docs, especially regarding nix #1631

Merged

Jade merged 5 commits from Henry-Hiles/continuwuity:quad/feat/update-build-docs into main 2026-04-10 08:11:44 +00:00

Conversation 7 Commits 5 Files changed 2 +39 -43

Henry-Hiles commented 2026-04-08 20:51:38 +00:00

Contributor

Copy link

This pull request updates the build docs to more closely match new changes.

Pull request checklist:

• This pull request targets the main branch, and the branch is named something other than
  main.
• I have written an appropriate pull request title and my description is clear.
• I understand I am responsible for the contents of this pull request.
• I have followed the contributing guidelines:
  • My contribution follows the code style, if applicable.
  • I ran pre-commit checks before opening/drafting this pull request.
  • I have tested my contribution (or proof-read it for documentation-only changes)
    myself, if applicable. This includes ensuring code compiles.
  • My commit messages follow the commit message format and are descriptive.
  • I have written a news fragment for this PR, if applicable.

<!-- In order to help reviewers know what your pull request does at a glance, you should ensure that 1. Your PR title is a short, single sentence describing what you changed 2. You have described in more detail what you have changed, why you have changed it, what the intended effect is, and why you think this will be beneficial to the project. If you have made any potentially strange/questionable design choices, but didn't feel they'd benefit from code comments, please don't mention them here - after opening your pull request, go to "files changed", and click on the "+" symbol in the line number gutter, and attach comments to the lines that you think would benefit from some clarification. --> This pull request updates the build docs to more closely match new changes. <!-- Example: This pull request allows us to warp through time and space ten times faster than before by double-inverting the warp drive with hyperheated jump fluid, both making the drive faster and more efficient. This resolves the common issue where we have to wait more than 10 milliseconds to engage, use, and disengage the warp drive when travelling between galaxies. --> <!-- Closes: #... --> <!-- Fixes: #... --> <!-- Uncomment the above line(s) if your pull request fixes an issue or closes another pull request by superseding it. Replace `#...` with the issue/pr number, such as `#123`. --> **Pull request checklist:** <!-- You need to complete these before your PR can be considered. If you aren't sure about some, feel free to ask for clarification in #dev:continuwuity.org. --> - [x] This pull request targets the `main` branch, and the branch is named something other than `main`. - [x] I have written an appropriate pull request title and my description is clear. - [x] I understand I am responsible for the contents of this pull request. - I have followed the [contributing guidelines][c1]: - [x] My contribution follows the [code style][c2], if applicable. - [ ] I ran [pre-commit checks][c1pc] before opening/drafting this pull request. - [x] I have [tested my contribution][c1t] (or proof-read it for documentation-only changes) myself, if applicable. This includes ensuring code compiles. - [x] My commit messages follow the [commit message format][c1cm] and are descriptive. - [ ] I have written a [news fragment][n1] for this PR, if applicable<!--(can be done after hitting open!)-->. <!-- Notes on these requirements: - While not required, we encourage you to sign your commits with GPG or SSH to attest the authenticity of your changes. - While we allow LLM-assisted contributions, we do not appreciate contributions that are low quality, which is typical of machine-generated contributions that have not had a lot of love and care from a human. Please do not open a PR if all you have done is asked ChatGPT to tidy up the codebase with a +-100,000 diff. - In the case of code style violations, reviewers may leave review comments/change requests indicating what the ideal change would look like. For example, a reviewer may suggest you lower a log level, or use `match` instead of `if/else` etc. - In the case of code style violations, pre-commit check failures, minor things like typos/spelling errors, and in some cases commit format violations, reviewers may modify your branch directly, typically by making changes and adding a commit. Particularly in the latter case, a reviewer may rebase your commits to squash "spammy" ones (like "fix", "fix", "actually fix"), and reword commit messages that don't satisfy the format. - Pull requests MUST pass the `Checks` CI workflows to be capable of being merged. This can only be bypassed in exceptional circumstances. If your CI flakes, let us know in matrix:r/dev:continuwuity.org. - Pull requests have to be based on the latest `main` commit before being merged. If the main branch changes while you're making your changes, you should make sure you rebase on main before opening a PR. Your branch will be rebased on main before it is merged if it has fallen behind. - We typically only do fast-forward merges, so your entire commit log will be included. Once in main, it's difficult to get out cleanly, so put on your best dress, smile for the cameras! --> [c1]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md [c2]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/docs/development/code_style.mdx [c1pc]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#pre-commit-checks [c1t]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#running-tests-locally [c1cm]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#commit-messages [n1]: https://towncrier.readthedocs.io/en/stable/tutorial.html#creating-news-fragments

Henry-Hiles added 3 commits 2026-04-08 20:51:38 +00:00

feat: update build docs c5fda0ac1e

feat: more specific docs on how to use the flake nix package 6a0f0e9616

chore: remove nix hardened profile docs as the hardened profile will was removed from nixpkgs. ... ab547bc500

See https://github.com/NixOS/nixpkgs/pull/501199

Henry-Hiles commented 2026-04-08 20:57:11 +00:00

Author

Contributor

Copy link

Looks like VSCode decided to reformat some stuff. I don't think the formatting is incorrect, but let me know if I need to undo that.

Looks like VSCode decided to reformat some stuff. I don't think the formatting is incorrect, but let me know if I need to undo that.

forgejo-actions commented 2026-04-08 21:22:45 +00:00

Copy link

Please add a changelog fragment to changelog.d/ describing your changes.

<!-- changelog-check-action --> Please add a changelog fragment to `changelog.d/` describing your changes.

Henry-Hiles commented 2026-04-08 21:40:24 +00:00

Author

Contributor

Copy link

@forgejo-actions wrote in #1631 (comment):

Please add a changelog fragment to changelog.d/ describing your changes.

Nope, I won't ^-^

@forgejo-actions wrote in https://forgejo.ellis.link/continuwuation/continuwuity/pulls/1631#issuecomment-27703: > Please add a changelog fragment to `changelog.d/` describing your changes. Nope, I won't ^-^

😭 1

lveneris commented 2026-04-09 09:36:45 +00:00

Contributor

Copy link

I believe the repo uses markdownlint, so whether or not you need to change it depends on what you used, but it is odd that your editor decided to reformat it differently.

I believe the repo uses markdownlint, so whether or not you need to change it depends on what you used, but it is odd that your editor decided to reformat it differently.

Henry-Hiles added 2 commits 2026-04-09 15:13:39 +00:00

fix: multiple top-level headers in generic file 1069359441

fix: indentation in nixos file dc405673d8

Henry-Hiles commented 2026-04-09 15:13:55 +00:00

Author

Contributor

Copy link

@lveneris wrote in #1631 (comment):

I believe the repo uses markdownlint, so whether or not you need to change it depends on what you used, but it is odd that your editor decided to reformat it differently.

I've fixed any markdownlint issues I introduced, now.

@lveneris wrote in https://forgejo.ellis.link/continuwuation/continuwuity/pulls/1631#issuecomment-27713: > I believe the repo uses markdownlint, so whether or not you need to change it depends on what you used, but it is odd that your editor decided to reformat it differently. I've fixed any `markdownlint` issues I introduced, now.

👍 1

nyanbinary commented 2026-04-09 19:25:56 +00:00

Contributor

Copy link

For Nix I think it would be wise to show a example of how to do a override to get a specific feature for example as well.

For Nix I think it would be wise to show a example of how to do a override to get a specific feature for example as well.

Henry-Hiles commented 2026-04-09 19:33:18 +00:00

Author

Contributor

Copy link

@nyanbinary wrote in #1631 (comment):

For Nix I think it would be wise to show a example of how to do a override to get a specific feature for example as well.

I guess so, I don't really want to write all that right now, maybe could be done in a future PR?

@nyanbinary wrote in https://forgejo.ellis.link/continuwuation/continuwuity/pulls/1631#issuecomment-27733: > For Nix I think it would be wise to show a example of how to do a override to get a specific feature for example as well. I guess so, I don't really want to write all that right now, maybe could be done in a future PR?

Jade added the

Documentation

label 2026-04-10 08:11:35 +00:00

Jade merged commit a79e7a01a8 into main 2026-04-10 08:11:44 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

Blocked

This pull request or issue is currently blocked from being merged/closed

  

Bug

Something isn't working as intended

  

Changelog

Added

Changelog entry added

  

Changelog

Missing

No changelog when one is needed

  

Changelog

None

Changelog is unnecesary for this change

  

Cherry-picking

Commits picked from other conduit projects

  

Database

This requires or includes changes to the database

  

Dependencies

Something dependency related

  

Dependencies/Renovate

Automatic dependency upgrades by Renovate

  

Difficulty

Easy

Low difficulty to implement - touches few parts of the codebase, low complexity

  

Difficulty

Hard

High difficulty to implement - touches many parts of the codebase, high complexity

  

Difficulty

Medium

Medium difficulty to implement - touches more parts of the codebase, higher complexity

  

Documentation

Improvements or additions to documentation

  

Enhancement

New feature or request

  

Good first issue

Good for newcomers

  

Help wanted

Additional eyes and keyboards are required for this one

  

Inherited

Issues that have been inhereted from the project pre-fork

  

Matrix/Administration

Features pertaining to homeserver administration

  

Matrix/Appservices

Features pertaining to the appservice API

  

Matrix/Auth

Features pertaining to authentication

  

Matrix/Client

Features pertaining to client-to-server interactions

  

Matrix/Core

Issues relating to core matrix functionality, such as state resolution and PDU formats

  

Matrix/E2EE

Issues related to end to end encryption

  

Matrix/Federation

Features pertaining to server-to-server interactions

  

Matrix/Hydra

Issues related to room version 12 and related changes (temporary label)

  

Matrix/MSC

Features pertaining to unstable matrix features

  

Matrix/Media

Features pertaining to media interactions

  

Matrix/T&S

Changes or issues related to trust & safety tooling

  

Merge

This PR is ready to be merged

  

Merge/Manual

This PR should be manually merged

  

Merge/Squash

This PR should be squashed when it is merged

  

Meta

Related to housekeeping, maintenance, or other repo-meta.

  

Meta/CI

Issues related to CI changes

  

Meta/Packaging

Packaging

  

Priority

Blocking

This issue is blocking the next release

  

Priority

High

This issue is very important

  

Priority

Low

This issue is of a rather low priority

  

Security

This item is related to general security

  

Status

Confirmed

This issue has enough information and is confirmed

  

Status

Duplicate

This issue or pull request already exists

  

Status

Invalid

This issue doesn't seem right

  

Status

Needs Investigation

This issue needs further investigation

  

Support

Questions or support requests

  

Wont fix

This will not be worked on

  

old/ci/cd

Ci/CD

Archived

  

old/rust

Pull requests that update Rust code

Archived

No labels

Blocked

Bug

Changelog

Added

Changelog

Missing

Changelog

None

Cherry-picking

Database

Dependencies

Dependencies/Renovate

Difficulty

Easy

Difficulty

Hard

Difficulty

Medium

Documentation

Enhancement

Good first issue

Help wanted

Inherited

Matrix/Administration

Matrix/Appservices

Matrix/Auth

Matrix/Client

Matrix/Core

Matrix/E2EE

Matrix/Federation

Matrix/Hydra

Matrix/MSC

Matrix/Media

Matrix/T&S

Merge

Merge/Manual

Merge/Squash

Meta

Meta/CI

Meta/Packaging

Priority

Blocking

Priority

High

Priority

Low

Security

Status

Confirmed

Status

Duplicate

Status

Invalid

Status

Needs Investigation

Support

Wont fix

old/ci/cd

old/rust

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

4 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

continuwuation/continuwuity!1631

No description provided.