docs: put the credentials prose on the overview and the tables on the reference
The folded-in secrets.md text sat after the reference's table, so the reference was half prose. The overview now holds all the prose (where a secret lives, topologies, the swarm- and hive-level notes, how a reader reaches the store, the browser UI, adding a secret) and the reference holds only the tables, each pointing at the section that explains it. No text dropped; links that asked for the explanation now go to the overview, and the ones that asked for a list or a row go to the reference.
This commit is contained in:
parent
d273fa8028
commit
b53365e371
1 changed files with 618 additions and 593 deletions
|
|
@ -592,7 +592,7 @@ in
|
|||
|
||||
On a hive that runs the store, glue-bao-tls.nix supplies both as
|
||||
defaults and there is nothing to do. Elsewhere the leaf is issued
|
||||
from that CA out of band and named here — see docs/swarm/credentials-reference.md.
|
||||
from that CA out of band and named here — see docs/swarm/credentials.md.
|
||||
'';
|
||||
}
|
||||
{
|
||||
|
|
@ -718,7 +718,7 @@ in
|
|||
# with it, so skipping the store when the producer is local would buy a
|
||||
# round trip and cost a second delivery path, a second way for the file
|
||||
# to be wrong, and a gate whose false arm is a Grafana with no login.
|
||||
# Recorded in docs/swarm/credentials-reference.md.
|
||||
# Recorded in docs/swarm/credentials.md.
|
||||
#
|
||||
# It is a store reader, and this is what the store's readers do: a cert
|
||||
# login that fails LOUDLY, since every state it fails on is one a retry
|
||||
|
|
|
|||
Loading…
Reference in a new issue