Glossary names in code; default proxy CA named multiproxy CA #51

Merged

mikluko merged 1 commit from refactor/glossary-names into main

2026-10-26 22:58:56 +00:00

mikluko commented

2026-10-26 22:57:20 +00:00

Owner

Brings the code in line with GLOSSARY.md, and renames the default proxy CA.

Glossary names. The issuer API called the proxy CA a root, a word the glossary avoids. NewRoot, RootTemplate, SelfSignedCA.RootBitSize, SelfSignedCA.RootTmpl, DefaultIssuerRootBitSize and DefaultIssuerRootTmpl become NewCA, CATemplate, CABitSize, CATmpl, DefaultIssuerCABitSize and DefaultIssuerCATmpl, renamed with gopls so every reference moved. root.go becomes ca.go. Tests name their upstream servers upstream and tlsUpstream instead of backend and tlsBackend.

Default proxy CA. A generated proxy CA was named root.example.org of Multiproxy Root Org. Its template also carried a placeholder DNS name, OCSP server and issuer name. It is now multiproxy CA of multiproxy, and DefaultIssuerCATmpl is built by CATemplate, so the library and the command share one definition. The leaf template loses its placeholder country (AQ) and its fixed serial, which Issue always replaced.

A CA read from -ca-cert keeps its name, so existing installations are unaffected. The reference lists the new defaults, and the changelog marks the renames as breaking.

Remaining avoid-word matches are standard library or HTTP terms (net.Listener, pem.Block, net.Pipe, net/http Hijack), not the glossary's concepts.

Brings the code in line with GLOSSARY.md, and renames the default proxy CA. **Glossary names.** The `issuer` API called the proxy CA a root, a word the glossary avoids. `NewRoot`, `RootTemplate`, `SelfSignedCA.RootBitSize`, `SelfSignedCA.RootTmpl`, `DefaultIssuerRootBitSize` and `DefaultIssuerRootTmpl` become `NewCA`, `CATemplate`, `CABitSize`, `CATmpl`, `DefaultIssuerCABitSize` and `DefaultIssuerCATmpl`, renamed with gopls so every reference moved. `root.go` becomes `ca.go`. Tests name their upstream servers `upstream` and `tlsUpstream` instead of `backend` and `tlsBackend`. **Default proxy CA.** A generated proxy CA was named `root.example.org` of `Multiproxy Root Org`. Its template also carried a placeholder DNS name, OCSP server and issuer name. It is now `multiproxy CA` of `multiproxy`, and `DefaultIssuerCATmpl` is built by `CATemplate`, so the library and the command share one definition. The leaf template loses its placeholder country (`AQ`) and its fixed serial, which `Issue` always replaced. A CA read from `-ca-cert` keeps its name, so existing installations are unaffected. The reference lists the new defaults, and the changelog marks the renames as breaking. Remaining avoid-word matches are standard library or HTTP terms (`net.Listener`, `pem.Block`, `net.Pipe`, net/http `Hijack`), not the glossary's concepts.

mikluko added 1 commit

2026-10-26 22:57:21 +00:00

Glossary names in code; default proxy CA named multiproxy CA

CI / changelog (pull_request) Successful in 6s

Details

CI / test (pull_request) Successful in 1m10s

Details

a9e344c0d6

The issuer API called the proxy CA a root, a word the glossary avoids:
NewRoot, RootTemplate, RootBitSize, RootTmpl and their defaults become CA
names, renamed with gopls, and root.go becomes ca.go. Tests name their
upstream servers upstream instead of backend.

A generated proxy CA was named root.example.org of Multiproxy Root Org,
and its template carried a placeholder DNS name, OCSP server and issuer
name; it is now multiproxy CA of multiproxy, built by CATemplate. The leaf
template loses its placeholder country and fixed serial.

mikluko merged commit e89dd4418b into main

2026-10-26 22:58:56 +00:00

mikluko deleted branch refactor/glossary-names

2026-10-26 22:58:56 +00:00

mikluko referenced this pull request from a commit

2026-10-26 22:58:56 +00:00

Merge pull request 'Glossary names in code; default proxy CA named multiproxy CA' (#51) from refactor/glossary-names into main