[Chapel Merge] This PR contains some minor `locale` documentation

Branch: refs/heads/main
Revision: 576e5c5
Author: jeremiah-corrado
Link: `locale` documentation improvements by jeremiah-corrado · Pull Request #20332 · chapel-lang/chapel · GitHub
Log Message:

Merge pull request #20332 from jeremiah-corrado/locale-doc-improvements

This PR contains some minor locale documentation improvements. Return types were added to hostname, name, and id. More information about the difference between name and hostname w.r.t oversubscription was also included.

[reviewed by @vasslitvinov]

Modified Files:
M modules/internal/ChapelLocale.chpl

Compare: https://github.com/chapel-lang/chapel/compare/2a1f9571bb43...576e5c548a6b