!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

381 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 70 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
23 Sep 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org
am I right in assuming nix+nixpkgs+nixos manuals and wiki.nixos.org have a lot of overlap in people contributing?
*

Eh, not that much. There are like 2-3 regular contributors who have touched all of them, but otherwise these are mostly disjoint groups as far as I can tell.

I mean, it's complicated. Define "a lot". There's not that many people working on documentation overall.

21:20:30
@fricklerhandwerk:matrix.orgfricklerhandwerk *

Eh, not that much. There are like 2-3 regular contributors who have touched all of them, but otherwise these are mostly disjoint groups as far as I can tell. I may be wrong.

I mean, it's complicated. Define "a lot". There's not that many people working on documentation overall.

21:20:53
@phanirithvij:matrix.orgloudgolemI found wiki to be easier to contribute to definitely21:21:24
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org
maybe a single gha which checks external links among all manuals + home-pages + wiki-dump could work?
They all have very different update cycles, and running the checks in some other location from where the source is modified will just lead to people having to jump hoops. Had that with the Nix manual, please don't.
21:21:56
@phanirithvij:matrix.orgloudgolemok so gha per repo then, tested on corresponding stable manuals and sites and each repo can adjust the run frequency per its release cycle21:25:43
@phanirithvij:matrix.orgloudgolemthis doesn't need an rfc does it?21:28:50
@phanirithvij:matrix.orgloudgolem

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial toy repo?
  • also nixos-landscape has been offline for a long time, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

21:37:17
@phanirithvij:matrix.orgloudgolem *

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial toy repo?
  • also nixos-landscape has been offline for quite a while, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

21:37:33
@phanirithvij:matrix.orgloudgolem *

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial toy repo?
  • also nixos-landscape has been unreachable for quite a while, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

21:38:56
@phanirithvij:matrix.orgloudgolem *

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial toy repo?
  • also nixos-landscape has been inaccesible for quite a while, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

21:39:06
@phanirithvij:matrix.orgloudgolem *

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial personal repo?
  • also nixos-landscape has been inaccesible for quite a while, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

21:39:29
@phanirithvij:matrix.orgloudgolem *

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial personal repo?
  • also nixos-landscape has been inaccesible for quite a while, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long time inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

21:40:04
@phanirithvij:matrix.orgloudgolemrepology statistics could be useful too21:41:21
@phanirithvij:matrix.orgloudgolem going to bed, I'll see about the linkchecks via testers.lycheeLinkCheck across all these repos tomorrow 21:42:44
24 Sep 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org

I'm also interested in things like this https://discourse.nixos.org/t/nix-ecosystem-mind-map/28682/17
mindmaps, landscape, map-of-github, awesome-lists etc.

  • are the graphviz graphs in that thread maintained anywhere? say in some unofficial personal repo?
  • also nixos-landscape has been inaccesible for quite a while, that's a bummer

Another thing I'm interested in is to visualize/map nixpkgs health, i.e. how many packages are fresh, maintainer activity, most maintainted packages, packages without maintainers, long time inactive maintainers etc. all of these clearly visible somewhere like nixpkgs.health. I see rfc 180 which adresses a few of these.

For data wrangling, you may be interested in https://github.com/Nix-Security-WG/nix-security-tracker

There's a full DB model of Nixpkgs metadata and a worker for periodic evaluations. (The end game of this would be Hydra dumping all the information directly into the database for everyone to build tools around.)

00:34:33
@phanirithvij:matrix.orgloudgolem
In reply to @infinisil:matrix.org
ryantm: I guess especially @pennae, who has been saying a lot that nixos-render-docs can already render with multiple pages with some small changes to the code. Furthermore Johannes Kirschbauer @hsjobeki and danielsidhion who have been investigating existing docs rendering tools to see if we could maybe not roll our own tooling at all. Your PR introduces yet another custom-built tool 😅
has anything been done for rendering docs in multiple pages since this discussion?
07:51:46
@phanirithvij:matrix.orgloudgolemwould be cool if the epub build were fixed too07:52:38
@phanirithvij:matrix.orgloudgolem@johannes.kirschbauer:scs.ems.host is there a noogle matrix channel?08:00:49

Show newer messages


Back to Room ListRoom Version: 6