| 25 Jul 2023 |
 infinisil | nikstur: +1 from me, having documentation right next to the implementation makes it easy to update it | 13:52:04 |
 raboof | Redacted or Malformed Event | 13:59:42 |
 nikstur | In reply to @raboof:matrix.org
yeah, if you can change 'the thing' and 'the documentation for the thing' in the same commit, that's very helpful both when reviewing it and when looking at the change in the history But this would also be possible if the docs lay somewhere completely different in the repo | 14:02:31 |
| raboof | 🤦sorry I misread, nvm | 14:03:44 |
|  nf changed their profile picture. | 16:43:13 |
| 26 Jul 2023 |
| infinisil | asymmetric: Ping for https://github.com/nix-community/nixdoc/pull/62 :) | 16:50:41 |
 asymmetric | In reply to @infinisil:matrix.org
asymmetric: Ping for https://github.com/nix-community/nixdoc/pull/62 :) Traveling today, will look at it tomorrow hopefully | 19:53:14 |
| 27 Jul 2023 |
|  ribosomerocker joined the room. | 03:04:09 |
|  @quark97:matrix.org left the room. | 04:35:42 |
|  @viktor:kleen.org left the room. | 07:07:34 |
 alejandrosame | I won't be joining today's meeting. See you next week! | 12:01:50 |
| 29 Jul 2023 |
| infinisil | I won't be there for the Monday meeting | 12:33:54 |
 proofconstruction | I'm back in civilization and will be at the Monday meeting | 22:57:22 |
| 30 Jul 2023 |
|  h7x4 set a profile picture. | 08:30:49 |
| asymmetric | https://discourse.nixos.org/t/nixos-installation-instructions-could-use-a-lot-more-details/31062/6?u=asymmetric | 16:42:32 |
| asymmetric | Is the SE placement of the manuals something that the marketing team needs to work on (as in SEO), or is it dependent on us, for example by splitting the manual to reduce page load? | 16:43:47 |
| alejandrosame | Hello all! This issue shouldn't be too problematic, but if you have any considerations to improve the exposition I'll appreciate the feedback: https://github.com/NixOS/nixpkgs/issues/246234 | 18:55:07 |
|  Austin Horstman joined the room. | 20:03:38 |
| Austin Horstman changed their display name from Austin Horstman to Khaneliman. | 20:09:56 |
| Austin Horstman set a profile picture. | 20:12:06 |
 fricklerhandwerk | In reply to @asymmetric:matrix.dapp.org.uk
Is the SE placement of the manuals something that the marketing team needs to work on (as in SEO), or is it dependent on us, for example by splitting the manual to reduce page load? It seems to mainly hinge on the page size. Good tagging and summaries of smaller pages would surely have positive impact as well. | 21:26:43 |
| proofconstruction | In reply to @asymmetric:matrix.dapp.org.uk
Is the SE placement of the manuals something that the marketing team needs to work on (as in SEO), or is it dependent on us, for example by splitting the manual to reduce page load? It seems to mainly hinge on the page size. Good tagging and summaries of smaller pages would surely have positive impact as well. | 22:40:52 |
| proofconstruction | genuinely no idea what happened there. i guess i forwarded that message to this channel? finding some rough edges in fluffychat apparently! | 22:41:22 |
| proofconstruction | In reply to @alejandrosame:matrix.org
Hello all! This issue shouldn't be too problematic, but if you have any considerations to improve the exposition I'll appreciate the feedback: https://github.com/NixOS/nixpkgs/issues/246234 this is great - i really like the idea of labeling every (sub)section with the relevant diataxis category as a first step | 22:43:09 |
| proofconstruction | re: the installation guide on the wiki coming up in top search engine results - this is (in my opinion) another great reason to make an actually-official one (wiki.nixos.org?) that still has community-generated content. not really sure what happened historically to yield the present state of affairs, but it's confusing and bad as everyone keeps pointing out | 22:46:20 |
| proofconstruction | that is, community-generated in the sense of not being largely dependent on stewardship by the docs team, which is still under-resourced | 22:47:03 |
| 31 Jul 2023 |
| asymmetric | In reply to @fricklerhandwerk:matrix.org
It seems to mainly hinge on the page size. Good tagging and summaries of smaller pages would surely have positive impact as well. indeed:
- https://pagespeed.web.dev/analysis/https-nixos-org-manual-nixos-stable/0jv7c6prdy?form_factor=desktop
- https://pagespeed.web.dev/analysis/https-nixos-wiki-wiki-NixOS_Installation_Guide/6d6uu0tx4h?form_factor=desktop
| 09:22:57 |
 @pennae:matrix.eno.space | looking at the meeting notes; henrik-ch: for which manual are you looking for alternatives? | 15:40:40 |
| @pennae:matrix.eno.space | or rather, what's the goal for that manual regardless of tooling | 15:42:13 |
 henrik-ch | Hi pennae , thank you for reaching out - when you read the meeting minutes, you may think that I am doing something or being very concrete about manual rendering alternatives, but that is not the case, rather I am being very unconcrete I would say 😀. | 15:49:05 |
