!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

339 Members
Discussion about documentation improvements around the Nix ecosystem82 Servers

Load older messages


SenderMessageTime
23 Jun 2021
@ryantm:matrix.orgryantmI really don't think includes are necessary in the final thing.13:06:21
@ryantm:matrix.orgryantmThis is just another tool to help us incrementally convert.13:06:58
@blaggacao:matrix.orgDavid ArnoldAh ok, got ya! 👍13:48:03
@tnias:stratum0.orgtnias joined the room.14:40:10
@jtojnar:matrix.orgJan Tojnar ryantm: I still am not very fond of static global TOC 15:46:36
@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

There are no newer messages yet.


Back to Room ListRoom Version: 6