Page footer sections: "See also" vs. "Related sections"

[amotl]

Documentation feedback

• Page title: Ad-hoc queries
• Page URL: https://cratedb.com/docs/guide/start/query/ad-hoc.html
• Source: https://github.com/crate/cratedb-guide/blob/main/docs/start/query/ad-hoc.md

---

In the footer section of this page and sister pages, let's apply some "naming things" and cleanups/reorgs.

[amotl]

See also

GH-428 proposes to use "See also" to refer to further resources, like Microsoft's documentation is doing it across the board.

• https://learn.microsoft.com/en-us/dotnet/framework/data/adonet/#see-also
• https://learn.microsoft.com/en-us/dotnet/framework/configure-apps/#see-also
• https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe#see-also
• https://learn.microsoft.com/en-us/dotnet/framework/whats-new/#see-also

It can be small and large.

Related sections

Microsoft's documentation also provides a more verbose referal section, called "Related sections".

• https://learn.microsoft.com/en-us/dotnet/framework/development-guide#related-sections
• https://learn.microsoft.com/en-us/dotnet/framework/tools/#related-sections
• https://learn.microsoft.com/en-us/dotnet/framework/data/#related-sections

The teaser texts which are accompanying the links all start with verbs alternating between "provides", "describes", and "includes"; that also provides a sweet micro convention to possibly adhere to.