On Fri, 5 May 2023 14:28:01 GMT, Weijun Wang <wei...@openjdk.org> wrote:
> We have quite some `standard-names.html#anchorName` links (Ex: > > https://github.com/openjdk/jdk/blob/f804f2ce8ef7a859aae021b20cbdcd9e34f9fb94/src/java.base/share/classes/java/security/Signature.java#L111 > > ). I don't see any of them here. Is this style allowed in a `@spec` tag? > I also see no `#anchorName` for RFC links. > > And in this case, shall I also spell out the section name in the text? 1. You can use a relative URL, relative to the `specs` directory, so something like:<br> `@spec security/standard-names.html Standard Names` 2. The intent of the `@spec` tag is to identify the overall/root URL for each specification, not to identify all the interesting places within that specification. ------------- PR Comment: https://git.openjdk.org/jdk/pull/13336#issuecomment-1536766590