diff --git a/contributing-guides/style-guide.md b/contributing-guides/style-guide.md index d41f57d007..6cb68009ef 100644 --- a/contributing-guides/style-guide.md +++ b/contributing-guides/style-guide.md @@ -337,9 +337,9 @@ It should instead be simplified to make it easier for everyone to read: ### More information links -- On the `More information` link line, we prefer linking to the author's provided documentation of the command-line reference or the man page. When not available, use as the default fallback for all platforms +- On the `More information` link line, provide a direct link to documentation that instructs on how to use the command. We prefer linking to the author's provided documentation but when not available or very lacking in information, use as the default fallback for all platforms (except `osx` and BSD platforms other than FreeBSD). -Alternatively, you can link to the author's website or a tutorial page if the command doesn't have a documentation page. +If there is no documentation page to be found, you can link to the author's website or a third party tutorial. - For `osx`: Apple distributes the built-in man pages [in Xcode](https://developer.apple.com/documentation/os/reading_unix_manual_pages). For commands documented there, we recommend using , an HTML export of all Apple's man pages bundled with Xcode.