History

Versions 11

Version Author Diff Last updated
v11 Zen Fu
document the Tails machines naming scheme (tpo/tpa/team#42101) Picking a name from the documented naming scheme is a requirement for adding new nodes to the TPA Puppet Server. Because Tails machines were inherited by TPA and we didn't change their names, let's at least make sure that the status quo is documented.
v10 Zen Fu
turn frontmatter titles into valid YAML
v9 Antoine Beaupré
follow service page renames
v8 Antoine Beaupré
move small sections into YAML front matter This makes it more immediately visible to users reading the proposal by email or just browsing the website. Things like "affected users", "approval" and "deadline" are particularly things that rarely require a whole paragraph to describe. This also makes the contents greppable, which is particularly relevant for the Status field, which could now be used for automatic generation. That front matter is not currently very well displayed by GitLab wikis, but it's relatively readable. I have *tried* to move the "Summary" in there as well, but the formatting gets ugly quickly, as we need to use line continuation hacks. Besides, it looks better in the wiki that way. I have tried to do this automatically macros, but alas the format was too irregular so I had to actually do this manually, which means I also tweaked other things as I went along. Hopefully the format will make future work like this much easier.
v7 Antoine Beaupré
document the ganeti naming convention
v6 Antoine Beaupré
create a new "support" page The support page is the go-to page for the "how to get help" question, which previously was hidden inside the TPA-RFC-2 standard. This basically copies that part of the TPA-RFC-2 policy, but could eventually diverge without needing to update the policy, for informal stuff. I started working on this page while trying to address tpo/tpa/team#40382 ("document the triage process"), but I'm not actually sure triage documentation should go there, as this page feels more targeted at users, and only users. howto/incident-response.md would seem like a better space for this. Also, this is a toplevel page because it's more important than everything else, so it warrants its own special space.
v5 Jerome Charaoui
fix typo
v4 Antoine Beaupré
non-normative: two more naming policies
v3 Antoine Beaupré
non-binding RFC change: add references to naming convention
v2 Antoine Beaupré
deprecate location-based names
v1 Antoine Beaupré
move naming scheme to a policy