Alt-Svc and HSTS cache files link to removed documentation

[jbosboom]

I did this

I looked at Alt-Svc and HSTS cache files created by curl 8.11.0, which have headers

# Your alt-svc cache. https://curl.se/docs/alt-svc.html
# This file was generated by libcurl! Edit at your own risk.

and

# Your HSTS cache. https://curl.se/docs/hsts.html
# This file was generated by libcurl! Edit at your own risk.

I expected the following

I expected the URLs to lead to documentation describing the format of those files (if contractual) and providing user guidance about the impact of deleting those files. Instead they 404. The documentation seems to have been deliberately removed in #14553 and curl/curl-www@17eca87 because it is documented elsewhere. Consider redirecting to the other documentation. If there is no appropriate redirect, new versions of curl should stop emitting those URLs when writing the files.

(Whether this is a code bug or a docs bug depends on how you resolve it. I figured a clear report was more important than which issue template I used.)

curl/libcurl version

curl 8.11.0 (x86_64-pc-linux-gnu) libcurl/8.11.0 OpenSSL/3.4.0 zlib/1.3.1 brotli/1.1.0 zstd/1.5.6 libidn2/2.3.7 libpsl/0.21.5 libssh2/1.11.0 nghttp2/1.64.0 nghttp3/1.6.0
Release-Date: 2024-11-06
Protocols: dict file ftp ftps gopher gophers http https imap imaps ipfs ipns mqtt pop3 pop3s rtsp scp sftp smb smbs smtp smtps telnet tftp ws wss
Features: alt-svc AsynchDNS brotli GSS-API HSTS HTTP2 HTTP3 HTTPS-proxy IDN IPv6 Kerberos Largefile libz NTLM PSL SPNEGO SSL threadsafe TLS-SRP UnixSockets zstd

operating system

Linux promenade 6.12.3-arch1-1 #1 SMP PREEMPT_DYNAMIC Fri, 06 Dec 2024 11:15:43 +0000 x86_64 GNU/Linux