Draft: Backend docs #14840
Open
Draft: Backend docs #14840
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
jsoref
reviewed
Nov 11, 2024
Pull Request Test Coverage Report for Build 11813380634Details
💛 - Coveralls |
zeha
reviewed
Nov 11, 2024
ukleinek
force-pushed
the
backend-docs
branch
from
67c9833
to
3a78813
Compare
ukleinek
force-pushed
the
backend-docs
branch
from
3a78813
to
6427d89
Compare
|
The last push split out the change of itemize char from - to * into a separate commit to ease reviewing and I added the tense fix suggested by @jsoref in #14840 (comment). |
ukleinek
force-pushed
the
backend-docs
branch
3 times, most recently
from
6092180
to
268cf8d
Compare
|
Dropped |
Each backend that provides support for Primary also can do Autoprimary, so listing that separately isn't sensible. Before commit 45675c5 ("auth: catalog zone documentation") this column was titled "Super slave". Said commit then changed it wrongly to "Autoprimary". The right new term for "Super slave" is "Autosecondary". Adapt accordingly. Fixes: 45675c5 ("auth: catalog zone documentation")
Nearly all backend docs use * for their feature list. Upgrade that to "all".
Users shouldn't have to care about case handling and if a need is hit this is handled as a bug. So drop this documentation bit.
Make all the tables at the beginning of the backend detail descriptions describe the same properties in the same order. Stick to the order used in the overview table in index.rst. Also use the more politically correct names (i.e. Master -> Primary; Slave -> Secondary; Superslave -> Autosecondary).
For an event that happend at a definite time in the past, past simple is the right tense. Suggested-by: Josh Soref (josref)
ukleinek
force-pushed
the
backend-docs
branch
from
268cf8d
to
fd8d9d5
Compare
|
The patch adding the "Autosecondary" column was replaced by a patch renaming the "Autoprimary" column to "Autosecondary". Also dropped "Autoprimary" from the individual backend docs. So the things to fix before this can go in are: |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Short description
Make the feature lists of all backend docs consistently list the same properties
I didn't know for all added fields what the right value is, added "???" in that case. Happy for feedback about how to change them into the right values.
Checklist
I have: