!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

439 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
15 May 2023
@abathur:matrix.orgabathur joined the room.21:00:53
@abathur:matrix.orgabathur

cross-reporting from #marketing:nixos.org (https://matrix.to/#/!tPxtoBdChSsxHuBlNW:nixos.org/$PgasljhyDuZ2RX2W1XUzjc8CaaOuMyIaDKds7_5YwXk?via=matrix.org&via=nixos.dev&via=nixos.org) but someone in #nix:nixos.org reported that there are no titles in the links on https://nixos.org/learn.html

a quick skim makes me think these are sourced from nix.dev and I see the nix.dev flake consumed in the homepage repo, so I'm guessing this is a side-effect some restructuring the doc team is working on?

21:02:53
@abathur:matrix.orgabathur *

cross-reporting from #marketing:nixos.org (https://matrix.to/#/!tPxtoBdChSsxHuBlNW:nixos.org/$PgasljhyDuZ2RX2W1XUzjc8CaaOuMyIaDKds7_5YwXk?via=matrix.org&via=nixos.dev&via=nixos.org) but someone in #nix:nixos.org reported that there are no titles in the links on https://nixos.org/learn.html

a quick skim makes me think these are sourced from nix.dev and I see the nix.dev flake consumed in the homepage repo, so I'm guessing this is a side-effect of some restructuring the doc team is working on?

21:10:48
@zmitchell:matrix.org@zmitchell:matrix.orgThey are sourced from nix.dev, but I'm not exactly sure how.22:55:35
@fricklerhandwerk:matrix.orgfricklerhandwerkOh yes, that's the problem. Maybe we can just stop the including altogether: https://github.com/NixOS/nixos-homepage/pull/105422:57:12
17 May 2023
@shivaraj:matrix.orgshivaraj-bh changed their display name from Shivaraj B H to shivaraj-bh.12:31:05
@silvio:booq.org@silvio:booq.org joined the room.14:09:21
18 May 2023
@jyim:matrix.orgmaj joined the room.12:21:18
@asymmetric:matrix.dapp.org.ukasymmetricis it on purpose that on the board, when a PR is merged it gets marked as "postponed", rather than "done"? https://github.com/orgs/NixOS/projects/15/workflows/194606812:22:31
@zmitchell:matrix.org@zmitchell:matrix.orgAlmost certainly not13:00:07
@j-k:matrix.orgj-kswapped it now, can mention it in the call now or the normal docs call later today13:02:12
@fricklerhandwerk:matrix.orgfricklerhandwerkI disabled the workflows to add documentation-related things from Nixpkgs, NixOS, and Nix. It's way too much stuff we can't work off anyway, and will probably even be overwhelming for dedicated maintainers. I take care of the Nix manual already, so probably no need to dump that on the team unless there are broader issues.13:08:25
@asymmetric:matrix.dapp.org.ukasymmetric

i don't know if i'll be able to join the meeting today, so here's a little status update:

  • been mostly busy with maintaining nixdoc: want to understand rnix well, so can keep it up to date (and incorporate work from pennae that bumps rnix/rowan)
  • this also has lead me to review, and apply to become a shepherd for, the doc-comments RFC
  • i also started looking into how nix.dev can look+feel more official, and opened a couple PRs there

i think both of these will keep me busy for the next couple of weeks

13:41:36
@asymmetric:matrix.dapp.org.ukasymmetric *

i don't know if i'll be able to join the meeting today, so here's a little status update:

  • been mostly busy with maintaining nixdoc: want to understand it (and rnix/rowan) well, so can keep it up to date (and incorporate work from pennae that bumps rnix/rowan)
  • this also has lead me to review, and apply to become a shepherd for, the doc-comments RFC
  • i also started looking into how nix.dev can look+feel more official, and opened a couple PRs there

i think both of these will keep me busy for the next couple of weeks

13:41:56
@asymmetric:matrix.dapp.org.ukasymmetric *

i don't know if i'll be able to join the meeting today, so here's a little status update:

  • been mostly busy with maintaining nixdoc: want to understand it (and rnix/rowan) well, so can keep it up to date (and incorporate work from pennae that bumps rnix/rowan)
  • the context is the same, so this also has lead me to review, and apply to become a shepherd for, the doc-comments RFC
  • i also started looking into how nix.dev can look+feel more official, and opened a couple PRs there

i think both of these will keep me busy for the next couple of weeks

13:42:52
@asymmetric:matrix.dapp.org.ukasymmetric *

i don't know if i'll be able to join the meeting today, so here's a little status update:

  • been mostly busy with maintaining nixdoc: want to understand it (and rnix/rowan) well, so can keep it up to date (and incorporate work from pennae that bumps rnix/rowan)
  • the context is the same, so this also has lead me to review, and apply to become a shepherd for, the doc-comments RFC
  • i also started looking into how nix.dev can look+feel more official, and opened a couple PRs there: one and two

i think both of these will keep me busy for the next couple of weeks

13:43:48
19 May 2023
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host In case you need someone i‘ve worked quite a bit with rnix and nixdoc. So would be happy to answer questions. In case you have any. 12:13:52
20 May 2023
@charles:computer.surgeryCharles joined the room.02:55:21
@charles:computer.surgeryCharles Does Nix/NixOS have an equivalent documentation page to https://wiki.archlinux.org/title/Help:Reading#Installation_of_packages? 02:59:21
@charles:computer.surgeryCharlesI ask because I personally can't recall encountering such a thing (I've been using NixOS for nearly 2 years now I think), and if there really isn't one, I would be interested in trying to contribute it03:11:56
@kranzes:matrix.org@kranzes:matrix.org
In reply to @charles:computer.surgery
Does Nix/NixOS have an equivalent documentation page to https://wiki.archlinux.org/title/Help:Reading#Installation_of_packages?
We have it in the manual I believe
13:38:03
@kranzes:matrix.org@kranzes:matrix.orgimage.png
Download image.png
13:38:19
@kranzes:matrix.org@kranzes:matrix.orgthere's also this13:38:23
@kranzes:matrix.org@kranzes:matrix.orgimage.png
Download image.png
13:38:55
@kranzes:matrix.org@kranzes:matrix.orgimage.png
Download image.png
13:39:05
@charles:computer.surgeryCharles👀15:54:08
@wiseh:matrix.org@wiseh:matrix.org

Does Nix/NixOS have an equivalent documentation page to https://wiki.archlinux.org/title/Help:Reading#Installation_of_packages?

You may also be interested in this https://github.com/NixOS/nix.dev/issues/554

22:08:18
@charles:computer.surgeryCharlesooh, yes22:09:45
@charles:computer.surgeryCharlesthe main use-case i had in mind for such a piece of documentation is similar to how the Arch page is used throughout its wiki: instead of giving a concrete example of how to install a package, things just link to a generic page explaining all the ways it can be done (and ideally enumerating the differences between each method)22:19:41
@charles:computer.surgeryCharlesthe linked issue sounds like it's heading towards that sort of thing, which is great22:20:16

Show newer messages


Back to Room ListRoom Version: 6