| 11 Aug 2022 |
olaf | I just opened this PR I would like to know if the direction is appreciated. | 13:30:26 |
| olaf changed their display name from denna to olaf. | 13:30:58 |
John Ericson | https://github.com/NixOS/nix/pull/6420#issuecomment-1206226364 | 15:40:04 |
infinisil | https://github.com/orgs/NixOS/projects/15/views/1 | 15:52:06 |
Mic92 | John Ericson: https://hackmd.io/8MbOj5cfSF6QHw4J_tQVxw?edit | 15:56:19 |
olaf | https://github.com/NixOS/nix-book/blob/main/resources.md | 15:59:05 |
olaf | In reply to @denna:matrix.org I just opened this PR I would like to know if the direction is appreciated. here | 16:02:27 |
John Ericson | Mic92: we didn't discuss that much but I liked your nix.dev PR | 16:43:10 |
John Ericson | good indeed to introduce problem separate from niv | 16:43:17 |
Mic92 | John Ericson: I think you mean someone else? I don't think I created such a PR. | 16:44:44 |
John Ericson | oh yes oops that was olaf with https://github.com/NixOS/nix.dev/pull/303/files | 16:45:13 |
John Ericson | my ad | 16:45:17 |
fufexan | I was thinking of adding setting nixPath from flakes inputs to the wiki. Should that be done in the Flakes article or in a new article? It's basically only
{ inputs, ... }:
{
nix.nixPath = [
"nixpkgs=${inputs.nixpkgs}"
"home-manager=${inputs.home-manager}"
"system=${inputs.self}"
];
}
This would go along with showing how to add specialArgs = { inherit inputs; }; to a nixosSystem call.
Should I add this at all?
| 19:46:01 |
fufexan | * I was thinking of adding setting nixPath from flakes inputs, for compatibility with older nix tools, to the wiki. Should that be done in the Flakes article or in a new article? It's basically only
{ inputs, ... }:
{
nix.nixPath = [
"nixpkgs=${inputs.nixpkgs}"
"home-manager=${inputs.home-manager}"
"system=${inputs.self}"
];
}
This would go along with showing how to add specialArgs = { inherit inputs; }; to a nixosSystem call.
Should I add this at all?
| 19:46:44 |
| 12 Aug 2022 |
| * 夜坂雅 | Yorusaka Miyabi wonders if there's any requirements for NixOS documentation to use DocBook. | 01:42:12 |
pennae | pretty much everything except modules and the options we haven't touched yet use markdown as their primary format and just render to docbook as an intermediate format. some modules do that as well, albeit not automatically | 01:47:31 |
夜坂雅 | Yorusaka Miyabi | In reply to @pennae:matrix.eno.space pretty much everything except modules and the options we haven't touched yet use markdown as their primary format and just render to docbook as an intermediate format. some modules do that as well, albeit not automatically I thought that, eventually all NixOS module option docstrings are written in CommonMark. | 02:55:24 |
pennae | that's the plan :) | 02:56:11 |
pennae | hope we'll get there for 22.11 | 02:56:18 |
pennae | currently waiting for review on https://github.com/NixOS/nixpkgs/pull/185474 before we go any further | 02:57:00 |
夜坂雅 | Yorusaka Miyabi | In reply to @pennae:matrix.eno.space currently waiting for review on https://github.com/NixOS/nixpkgs/pull/185474 before we go any further In this PR I found that there's a remaining part that looks like DocBook. 😅 | 03:34:59 |
夜坂雅 | Yorusaka Miyabi | This PR looks good to me. BTW, is lib.mdDoc a marker ? | 03:36:43 |
pennae | it wraps the given text in a form make-options-doc recognizes as markdown so it can convert it to docbook, yes | 03:38:09 |
John Ericson | https://github.com/NixOS/nix/pull/6877#issuecomment-1212877941 Eelco commented providing more details why he doesn't like the arch chapter, and seems to be anti having a reference | 17:02:06 |
John Ericson | (I wrote that in the Nixpkgs arch chanel, but I meant to write that in this channel) | 17:03:02 |
John Ericson | Based on our call yesterday, I think we all disagree with that? | 17:03:19 |
John Ericson | so it would be good to do something as a team about that | 17:03:27 |
tpw_rules | is there a way to automatically extract that stuff into something that's not doxygen? | 19:13:48 |
John Ericson | tpw_rules: not in a good way | 19:27:28 |
John Ericson | doxygen is is per defintion code decs | 19:27:39 |