On Thu, 30 Mar 2023 20:38:13 GMT, Jonathan Gibbons <j...@openjdk.org> wrote:
> The initial assumption was "after the @param/@return/@throws group". Overall, > as I said in the description for this PR, the block tags are not very > consistent about ordering. I was thinking we might want to recommend an > overall ordering, but I'm worried it would be too intrusive a change to apply > generally. In the description, I suggested an ordering based on the order in > `Docs.gmk` which defines the order in which tags appear in the generated > output. Okay, I think it's just a few of the usages that I sampled had author tags left over from early JDK releases and they end up between the spec and see tags. We can fix these things up at another time. ------------- PR Comment: https://git.openjdk.org/jdk/pull/13248#issuecomment-1491696054