!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

398 Members
Discussion about documentation improvements around the Nix ecosystem79 Servers

Load older messages


SenderMessageTime
23 Jun 2021
@jtojnar:matrix.orgJan TojnarI think building the doc tree from included documents like docbook does is better for reducing the chance of merge conflicts, among other things15:49:41
@jtojnar:matrix.orgJan Tojnaralso having the tree would hopefully allow us to have per section TOCs15:50:42
@ryantm:matrix.orgryantmYeah, the per-section TOCs are an improvement, but I'm not sure it is worth the cost of spreading the TOC among multiple files and adding the complexity of includes.16:08:12
@domenkozar:matrix.orgDomen KožarI've refreshed the theme for https://nix.dev/, let me know what you think :)17:17:47
@ryantm:matrix.orgryantmI like all the links to the various sections.17:30:34
@b:chreekat.netbryan Domen Kožar: looks incredible 17:31:54
@jonringer:matrix.orgjonringeroverflow on the contents pane, :)17:32:33
@domenkozar:matrix.orgDomen Kožar jonringer: as in, too many levels? 17:33:08
@jonringer:matrix.orgjonringerpreviously, I wasn't able to scroll the ToC17:33:27
@domenkozar:matrix.orgDomen Kožarah yeah, that's finally fixed17:33:48
@jonringer:matrix.orgjonringer yea, the css setting is called overflow :) 17:34:02
@domenkozar:matrix.orgDomen Kožarit was much harder than that, so I decided to just switch the theme17:34:23
@domenkozar:matrix.orgDomen Kožar
In reply to @b:chreekat.net
Domen Kožar: looks incredible
Thanks :)
17:34:36
@b:chreekat.netbryanClicking suggest an edit took me to https://github.com/nix-dot-dev/nix.dev/edit/master/index.rst , which 404d17:34:55
@domenkozar:matrix.orgDomen KožarOuch :)17:35:32
@b:chreekat.netbryan"**The** Nix ecosystem is a DevOps toolkit..." 17:35:48
@b:chreekat.netbryan"Avoidance of version conflicts with already installed software." (Remove 'an')17:38:24
@domenkozar:matrix.orgDomen KožarWish there were articles in Slovenian, then this would be a lot easier :)17:39:18
@b:chreekat.netbryanHehe17:39:22
@b:chreekat.netbryanI'm going the other way now, learning a language that doesn't have articles. It seems weird at first, but then I don't even really miss them. I think it's funny17:49:47
@blaggacao:matrix.orgDavid Arnold ryantm: Thanks for polishing this off! Tie to open a bottle of champagne! 🍷 19:21:04
@blaggacao:matrix.orgDavid Arnold * ryantm: Thanks for polishing this off! Time to open a bottle of champagne! 🍷 19:21:14
@blaggacao:matrix.orgDavid Arnold🎉19:21:18
@ryantm:matrix.orgryantmWoo. Don't celebrate too much yet, we have a bunch more to convert.19:22:22
@ryantm:matrix.orgryantmFor people not following along, we finished converting all the release notes to CommonMark!19:23:11
@blaggacao:matrix.orgDavid Arnold
$ installation git:(master) cat *.xml | wc -l
1491
21:38:00
@blaggacao:matrix.orgDavid Arnold ryantm: what's the solution now for nested includes? 21:56:52
@blaggacao:matrix.orgDavid Arnold(within a regular md document)21:57:04
@ryantm:matrix.orgryantmI haven't made something to commit yet but I have an example of how to make it work with the top-level release notes file: https://github.com/ryantm/nixpkgs/commit/aa6b6594ef8f940169b9b426040d0259fd1bc88221:58:03
@blaggacao:matrix.orgDavid Arnoldalright let's go that way21:58:40

Show newer messages


Back to Room ListRoom Version: 6