| 12 Jul 2021 |
 matthewcroughan - nix.zone | Have you got the sources for how this was done? I have never implemented anything like that before and wonder how hard it could be. | 15:24:20 |
 andi- | In reply to @matthewcroughan:defenestrate.it
Have you got the sources for how this was done? I have never implemented anything like that before and wonder how hard it could be. Yeah, it is mostly just using lunr and hacking around it to make it useful for that POC https://github.com/andir/nixos.dev-option-search/blob/master/create-index.js | 15:28:35 |
| 20 Jul 2021 |
|  sumner left the room. | 21:43:02 |
| 21 Jul 2021 |
 samueldr | another person also had a similar PoC with the package search | 18:39:51 |
| samueldr | (shared when we were already committed to going with ES) | 18:40:03 |
| samueldr | not sure how/where it differs | 18:40:11 |
| samueldr | I've been using the options search a lot these past few days and... not been pleased with the irrelevance of the "relevant" results :( | 18:40:42 |
| samueldr | garbas: reminder that in 19 minutes there's that bi-weekly call | 18:41:30 |
| samueldr | (or not?) | 19:01:03 |
| samueldr | (there is) | 19:18:27 |
| samueldr | (there was) | 20:18:14 |
 tomberek | samueldr: this is what I meant by a non-invasive way to try out Nix: https://github.com/nix-dot-dev/nix.dev/pull/169 | 20:33:42 |
| samueldr | nice! | 20:34:21 |
| matthewcroughan - nix.zone | Huh I didn't realise you could contribute to nix.dev. That is certainly cool. Though I believe sphinx/rst are the wrong format to use, I may set up an alternative that uses MkDocs. MkDocs lets you use templating (jinja) and python to change the page contents, from within the MD file so you can have smart pages that have logic in them. Like if page.metadata == arm64 then include ../common/arm64.md | 20:42:37 |
| samueldr | ugh, please, not yet another source of documentation, it's already too fragmented | 20:43:35 |
| matthewcroughan - nix.zone | I was looking for evidence of automation/coding in the official Nix docs, and it looks like it's 100% hand written? | 20:43:43 |
| samueldr | "official docs" is still un flux because of RFC#whatever the one for markdown | 20:44:08 |
| samueldr | * "official docs" is still in flux because of RFC#whatever the one for markdown | 20:44:15 |
| matthewcroughan - nix.zone | I just don't think a lot of the stuff that is handwritten can be maintained. | 20:44:19 |
| matthewcroughan - nix.zone | Well it can, with dedication! But it's harder than it has to be. | 20:46:05 |
| andi- | Isn't everything apart from API docs manual writing anyway? How can you automate that and nix.dev is mostly not api docs IIRC. | 20:46:59 |
| samueldr | (to circle back to the actual topic, rather than fresh bikeshedding) tomberek: thanks, this will help with my lack of knowledge with docker when actually writing docs for $PROJECT | 20:47:31 |
| matthewcroughan - nix.zone | Of course not all can be. I'm just suggesting that sphinx/rst make it practically impossible to automate. | 20:48:17 |
| matthewcroughan - nix.zone | * Of course not all can be. I'm just suggesting that sphinx/rst make it practically impossible to automate anything other than Python docs. | 20:48:30 |
| matthewcroughan - nix.zone | https://squidfunk.github.io/mkdocs-material/reference/variables/ | 20:49:16 |
| matthewcroughan - nix.zone | I will not discuss here any further since I realise I'm overtaking the topic. My bad. | 20:49:37 |
| samueldr | right, tomberek, "authoring format" is probably another reason I forgot about when discussing that earlier | 20:53:48 |
| tomberek | samueldr: I’d be happy to do an bit of Docker introduction with you | 23:37:57 |
| samueldr | I kind of don't want to ;) | 23:38:21 |
| samueldr | makes it easier to gauge whether things only make sense to a docker enthusiast or not :) | 23:38:40 |
