!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

434 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
14 Aug 2023
@yukiisbored:matrix.orgYuki Langley (they/them)It's still complaining?15:34:01
@yukiisbored:matrix.orgYuki Langley (they/them)Is there a github repo/branch so I can take a look at the entire code?15:35:14
@mightyiam:matrix.org@mightyiam:matrix.orghttps://github.com/mightyiam/nix.dev/tree/mob/doctest15:37:49
@yukiisbored:matrix.orgYuki Langley (they/them)
In reply to @mightyiam:matrix.org
https://github.com/mightyiam/nix.dev/tree/mob/doctest
You need to but nix-repl in between brackets {} so MyST knows that it is a directive not a code-block: https://github.com/mightyiam/nix.dev/commit/575fafaa0137719732c042b8fe9fd583e51637eb#diff-e07c1c53347d65c8d474c94912ab24825952ee9b2cab073d8699afdfc6464934R121-R135
15:40:05
@yukiisbored:matrix.orgYuki Langley (they/them)
In reply to @yukiisbored:matrix.org

also just in case this is a syntax issue in your MyST/Markdown file, you do directives in MyST like this:

```{nix-repl}
nix-repl> 1 == 1
true
```
llike this
15:40:21
@yukiisbored:matrix.orgYuki Langley (they/them)
In reply to @yukiisbored:matrix.org

also just in case this is a syntax issue in your MyST/Markdown file, you do directives in MyST like this:

```{nix-repl}
nix-repl> 1 == 1
true
```
* like this
15:40:25
@yukiisbored:matrix.orgYuki Langley (they/them)Here's a more in-depth documentation on the directive syntax with MyST: https://myst-parser.readthedocs.io/en/v0.17.1/syntax/syntax.html#directives-a-block-level-extension-point15:43:26
@mightyiam:matrix.org@mightyiam:matrix.org We figured it out! proofconstruction was helpful despite my puns. 16:11:24
@mightyiam:matrix.org@mightyiam:matrix.orgAnd with that, the nix-repl doctester is ready for review. https://github.com/NixOS/nix.dev/pull/67216:12:27
15 Aug 2023
@10leej:matrix.org@10leej:matrix.org left the room.19:34:31
16 Aug 2023
@ninjatrappeur:alternativebit.fr@ninjatrappeur:alternativebit.fr changed their display name from NinjaTrappeur to NinjaTrappeur .: DECT 8711.19:55:24
17 Aug 2023
@infinisil:matrix.orginfinisilWould appreciate a review for https://github.com/NixOS/nixpkgs/pull/24822011:02:20
@roberthensing:matrix.orgRobert Hensing (roberth)I can only join the learning journey meeting today12:14:43
@asymmetric:matrix.dapp.org.ukasymmetrici'll be largely absent from meetings until sept, see you then!13:34:17
18 Aug 2023
@asymmetric:matrix.dapp.org.ukasymmetricdidn't we use to have a bot that commented on PRs with a url to ta preview version of nix.dev? 13:15:41
@asymmetric:matrix.dapp.org.ukasymmetricdidn't happen here: https://github.com/NixOS/nix.dev/pull/67913:16:14
@asymmetric:matrix.dapp.org.ukasymmetricwould love your feedback on https://github.com/NixOS/nix.dev/pull/68013:20:35
@zmitchell:matrix.org@zmitchell:matrix.org
In reply to @asymmetric:matrix.dapp.org.uk
didn't we use to have a bot that commented on PRs with a url to ta preview version of nix.dev?
I think that’s only for branches on the NixOS/nix.dev repo, not on PRs from forks
14:34:24
@zmitchell:matrix.org@zmitchell:matrix.org Jan Tojnar No, I asked a couple of questions on the issue and never got a response, so I didn’t want to spend time on it 14:35:24
@zmitchell:matrix.org@zmitchell:matrix.org Just FYI I'll be taking a short break from docs team meetings in the month of September. Not only do I need the break, but I'll be out of town at conferences (including NixCon) for the first half of the month so I wouldn't be able to attend those meetings anyway. 14:35:41
19 Aug 2023
@ninjatrappeur:alternativebit.fr@ninjatrappeur:alternativebit.fr changed their display name from NinjaTrappeur .: DECT 8711 to NinjaTrappeur.11:12:05
@zmitchell:matrix.org@zmitchell:matrix.org proofconstruction people really like your tutorial: https://www.reddit.com/r/NixOS/comments/15v1r4o/new_official_tutorial_series/?utm_source=share&utm_medium=ios_app&utm_name=ioscss&utm_content=2&utm_term=1 17:16:10
@proofconstruction:matrix.orgproofconstructionNice to log on to that win today17:47:17
@zmitchell:matrix.org@zmitchell:matrix.org An idea I had from one of the comments would be to create a list of “practice packages” selected from nixpkgs and grouped by difficulty to serve as a list of packaging exercises 21:19:11
@zmitchell:matrix.org@zmitchell:matrix.org Under each listing you could even have a `details` tag providing different hints so users don’t have to spoil themselves looking up the full build definition in nixpkgs 21:21:13
20 Aug 2023
@alejandrosame:matrix.orgalejandrosameJust finished writing the issue I mentioned during the last meeting -> https://github.com/NixOS/nixpkgs/issues/250376 . I'll start applying the new structure to the Python section starting tomorrow. If you take a look and have any feedback, I'll gladly read it! 16:12:10
21 Aug 2023
@mightyiam:matrix.org@mightyiam:matrix.orgSorry. Can't make it today. See you next time.14:27:04
@infinisil:matrix.orginfinisilHere's the next "This month in Nix docs" draft update: https://pad.lassul.us/BQletwJYRkWAVZ9HY76kGA, does this look to everyone?15:16:26
@infinisil:matrix.orginfinisilDid we miss any highlights?15:17:30
@zmitchell:matrix.org@zmitchell:matrix.org Since I missed July I was just going to do them both at the end of August. I think it’s premature to do August since the month isn’t over yet. 17:28:05

Show newer messages


Back to Room ListRoom Version: 6