# 2023-05-04 Documentation team meeting notes #45

**URL:** https://discourse.nixos.org/t/2023-05-04-documentation-team-meeting-notes-45/27874
**Category:** Documentation
**Created:** [May 4, 2023, 5:28pm UTC](https://discourse.nixos.org/t/2023-05-04-documentation-team-meeting-notes-45/27874 "2023-05-04T17:28:56Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![fricklerhandwerk](https://discourse.nixos.org/user_avatar/discourse.nixos.org/fricklerhandwerk/32/2029_2.png) [@fricklerhandwerk](https://discourse.nixos.org/u/fricklerhandwerk)
#### Post date: [May 4, 2023, 5:28pm UTC](https://discourse.nixos.org/t/2023-05-04-documentation-team-meeting-notes-45/27874/1 "2023-05-04T17:28:56Z")

</div>

- [Video conference](https://meet.jit.si/nix-documentation)
- [GitHub project board](https://github.com/orgs/NixOS/projects/15)
- [Team details](https://github.com/NixOS/nix.dev/tree/master/maintainers)
- [Past meeting notes](https://discourse.nixos.org/search?q=documentation%20team%20meeting)
- Attendees: @fricklerhandwerk @infinisil @zmitchell @asymmetric @henrik-ch @j-k, and some others
- Notes by: @infinisil

## Agenda

- Figure out what to do with how-to guides

### What to do with all the guides

- Examples:

- @fricklerhandwerk: Move to nix.dev, but how to organize them?

- @zmitchell: Goes into [Add recipes, reference, and contributing sections by zmitchell · Pull Request #520 · NixOS/nix.dev · GitHub](https://github.com/NixOS/nix.dev/pull/520), can continue on that

- @infinisil: Move into flat structure, sort out later?

- @asymmetric: Shouldn’t move until we have a clear position for nix.dev, still a separate domain, different from manuals

- @fricklerhandwerk: The question is: What’s the data type of a how-to guide?

- Looking at some guides, what are Nix, NixOS categories?

- @fricklerhandwerk: Brainstorming: Reference is API. Recipes/guides use pieces from different APIs and combines them together.

- How to do tags with sphinx?

- Let’s go through some guides and assign tags, as an exercise:

- @infinisil: Let’s use tags, but need infrastructure for rendering it

- @fricklerhandwerk: Other generic information for guides: Prerequisites for using it, which tutorials in the “knolwedge graph”

- @infinisil: To progress: Show how to have the flat list in nix.dev, just start with tags, might be enough to move

- A guide how to structure guides:

- Should how to fix errors/troubleshooting be included in guides?

- @henrik-ch: Can we move bits from the wiki?

- @zmitchell: Regarding tooling there’s lots of sphinx extensions, but not a lot of them are packaged for Nix

- @infinisil: Let’s maybe assign action items to members who aren’t here, more asynchronous

### Action items

- @fricklerhandwerk: Write out the drafted guide for writing guides
- @zmitchell: Create an issue to figure out how to integrate tags into Sphinx