!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

437 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
25 Aug 2023
@ryantm:matrix.orgryantmIt already supports admonitions (:::), though not all the formats used by Nixpkgs right now, like it doesn't support anchors inside admonitions.22:41:21
@ryantm:matrix.orgryantmHeaders are already linkable. TOCs is the primary way it works, you have to specify the TOC of each page included. No footnote support currently. https://ryantm.github.io/mmdoc/usage/#usage22:42:43
@ryantm:matrix.orgryantmThe parsers for these various addons are at https://github.com/ryantm/mmdoc/blob/main/src/parse.c22:43:48
@ryantm:matrix.orgryantmcmark has this way of hooking into its renderer to provide your own stuff: https://github.com/ryantm/mmdoc/blob/5f5a2734595cf42167cef2bb3c0e61cdc0185119/src/render.c#L45322:47:42
26 Aug 2023
@lucperkins:matrix.orgLuc PerkinsOkie doke! Not arguing for or against, just curious00:32:46
28 Aug 2023
@mightyiam:matrix.org@mightyiam:matrix.orgSorry. We relocated recently. Lots of house chores. "I'm a software developer!", I keep saying. "Why am I doing plumbing work? Why am I hanging drapes?". Anyway, I'll try to get some progress on extracting the doctester into its own repo soon. That's my update.13:47:55
@mightyiam:matrix.org@mightyiam:matrix.orgThank ya'll for your works.13:48:16
29 Aug 2023
@lurkki:pikaviestin.fiLurkki joined the room.15:42:38
30 Aug 2023
@wackbyte:matrix.orgwackbyte changed their profile picture.20:25:59
31 Aug 2023
@infinisil:matrix.orginfinisilNote that I'll continue abstaining from the doc team meetings for now, probably until after Nixcon12:45:17
@zmitchell:matrix.org@zmitchell:matrix.orgThe Jitsi room says that I need to wait for a moderator to let me in?13:01:48
@zmitchell:matrix.org@zmitchell:matrix.orgThat's pretty new13:02:13
@garbas:matrix.org@garbas:matrix.org zmitchell: I had the same problem yesterday at the marketing meeting. I solved it by creating the account 13:02:51
@zmitchell:matrix.org@zmitchell:matrix.orgInteresting13:03:34
@zmitchell:matrix.org@zmitchell:matrix.orgThanks13:03:38
@qyliss:fairydust.spaceAlyssa Rosshttps://jitsi.org/blog/authentication-on-meet-jit-si/13:04:28
@alejandrosame:matrix.orgalejandrosameI won't be a le to join today's since I'll be in transit13:13:07
@tiagod:matrix.orgtdillenburg joined the room.13:36:21
@asymmetric:matrix.dapp.org.ukasymmetrichey, the decision at the end (not sure whether it was taken or not) felt a bit rushed to me. with just a little more time we could've easily have reached unanimity imo15:10:35
@asymmetric:matrix.dapp.org.ukasymmetrici understand it's not a super high priority decision, but still my pref would've been to dedicate a little bit more time to it15:11:18
@asymmetric:matrix.dapp.org.ukasymmetricwe were only 6 people in the call after all, it should be possible 🙂15:11:40
@moritz.hedtke:matrix.orgmoritz.hedtke removed their display name moritz.hedtke.16:13:14
@proofconstruction:matrix.orgproofconstruction I agree it felt rushed. There was no further discussion/action after the thumbs-up general agreement. I would like to further discuss (here or ideally in the thread of a PR proposing concrete changes) some of the ideas for implementing this. 18:21:09
@infinisil:matrix.orginfinisilWhat is the context?18:24:56
@infinisil:matrix.orginfinisil proofconstruction: asymmetric: ^ 18:25:10
@proofconstruction:matrix.orgproofconstruction We had some more discussion around how/whether to include mention (or more) of unofficial tooling, including commercial products in the ecosystem. Examples that came up were the pinning nixpkgs tutorial which explains a niv workflow, and the GitHub Actions CI tutorial which (my opinion, my words, etc) is really just a Cachix/Magic Nix Cache advertisement instead of a tutorial. The final thing that happened in the meeting was a thumbs-up/down "vote" for whether to mention 3rd-party FOSS tools on nix.dev. (It wasn't really a vote in the sense of establishing a mandate/obligating a specific action be taken, but I can't think of a better word for this currently). Separately, we essentially dropped discussion around mentioning commercial stuff, with some agreement (not consensus here either, no decisions, etc) to kick that question back to the foundation board, though this is more contentious (especially given the current climate around governance). 18:50:57
@infinisil:matrix.orginfinisilI see, thanks!19:00:34
@infinisil:matrix.orginfinisilI don't have a big opinion on this, doesn't seem worth spending too much time on for now19:00:47
@infinisil:matrix.orginfinisil(well, it's part of the bigger question for how to onboard and offboard official projects, which is definitely worth discussing)19:02:33
@proofconstruction:matrix.orgproofconstruction Yes, it's certainly not a high priority compared to e.g making sure we actually have documentation for the official projects, or improving this team's PR -> review -> merge velocity. Just echoes some broader discussion currents happening in the community. 19:08:01

Show newer messages


Back to Room ListRoom Version: 6