* Switch to CommonMark for documentation
This RFC proposes to convert the documentation for the Nix, Nixpkgs
and NixOS projects from Docbook to CommonMark Markdown. It proposes
requirements for web facing documentation. It does not mandate
a choice of toolchain to generate a website with documentation. The
choice is left to the implementers and maintainers.
* Update rfcs/0000-commonmark-docs.md
Co-authored-by: Profpatsch <mail@profpatsch.de>
* Update rfcs/0000-commonmark-docs.md
Co-authored-by: Frederik Rietdijk <freddyrietdijk@fridh.nl>
* Update rfcs/0000-commonmark-docs.md
Co-authored-by: davidak <davidak@users.noreply.github.com>
* Update rfcs/0000-commonmark-docs.md
Co-authored-by: davidak <davidak@users.noreply.github.com>
* Update rfcs/0000-commonmark-docs.md
Co-authored-by: Ryan Mulligan <ryan@ryantm.com>
* Add shepherd metadata
* Add shepherd metadata
* Allow CommonMark plus small number of extensions
The exact set of extensions used is left to the documentation team.
* Final adjustments
- Nix now already uses markdown
- Fix grammar mistake
- Remove requirement of extensions having to be supported by
at least 3 toolchains
- Add requirement for an extension for references
- Rename the file to its designated name
Co-authored-by: Profpatsch <mail@profpatsch.de>
Co-authored-by: Frederik Rietdijk <freddyrietdijk@fridh.nl>
Co-authored-by: davidak <davidak@users.noreply.github.com>
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
Co-authored-by: Ryan Mulligan <ryan@ryantm.com>
Co-authored-by: Linus Heckemann <git@sphalerite.org>
Co-authored-by: Silvan Mosberger <contact@infinisil.com>
* Expand the RFC acronym at least once
While it is probably know to most it should also be documented what we expand RFC to.
* Capitalize "RFC"
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
* A small RFC on deprecating URL syntax
* Convert alternatives to a list
* Add a mention of tooling in future work
* A remark from @globin about one more problem with unquoted URLs
* Grammar edit: comparison of URLs, paths and strings.
Co-Authored-By: 7c6f434c <7c6f434c@mail.ru>
* Style edit: possibility of future removal
Co-Authored-By: 7c6f434c <7c6f434c@mail.ru>
* 0045: commit to using the tooling that now exists
* Update rfcs/0045-deprecate-url-syntax.md
Shepherd team
Co-Authored-By: Domen Kožar <domen@enlambda.com>
* Fix shepherd list
* Update based on a discussion
* Explicitly make future removal conditional on editions; restrict the claim about no special support to the Nix language itself
This paragraph seems to be a leftover or copy-pasta from the RFC template. It doesn't really fit into the flow of the text, so I think it was included or left here by mistake.
* rfc51: close stale issues initial draft
* rfc0051: use staleLabel consistent with nixpkgs labeling conventions
* rfc0051: do not close issues
* rfc0051: reword motivation
* record the members of the shepherd team
* Update rfcs/0051-mark-stale-issues.md
Co-Authored-By: asymmetric <lorenzo@mailbox.org>
* [RFC 0051] remove references to "issue" in stale message
* 0036-rfc-process-team-amendment: draft
Co-authored-by: Graham Christensen <graham@grahamc.com>
* 0036-rfc-process-team-amendment: clarifications
Co-Authored-By: globin <mail@glob.in>
* 0036-rfc-process-team-amendment: remove typo recommendation
The github UI has improved since this was written and we should no
longer discourage this.
* 0036-rfc-process-team-amendment: Glossary -> Terminology
* 0036-rfc-process-team-amendment: disallow author/co-author as Shepherds
* 0036-rfc-process-team-amendment: incorporate feedback from discussion
* 0036-rfc-process-team-amendment: update rfc process graph
* 0036-rfc-process-team-amendment: merge postpone and reject
* 0036-rfc-process-team-amendment: improve Shepherd Leader paragraph
* copy rfc template, unnumbered as of yet
* musl-libc RFC: first draft
* musl-libc RFC: rename to patch pull req number
* musl-libc: whoops, no links in top bit, that's metadata.
Move links to later.
* record the name of a brave co-author
* musl rfc: squash second batch of changes
* rfc: specify initial team \o/, add a small clarification.
* Add myself to the "musl team"