Fix documentation for linkgroups (#2369)

website/docs/linkgroups.md

@@ -1,13 +1,45 @@
-Turns on/off linkgroups for gcc/clang in the gmake backend.
+Turns on or off the linkgroups for option for linked libraries.
+
+Notes:
+
+Projects using GCC or Clang will use order dependent linking by default with the default linker. While it is generally believed to be slower, this option enables order independent linking within a group of libraries by putting them inside of a link-group using the `-Wl,--start-group` and `-Wl,--end-group` linker command line arguments.
 
 ```lua
 linkgroups ("value")
 ```
 
 ### Parameters ###
 
-`value` is a boolean value, i.e. "On" or "Off".
+`value` is one of:
+
+| Value   | Description                                       |
+|---------|---------------------------------------------------|
+| On      | Turn on link groups.                              |
+| Off     | Turn off link groups.                             |
+
+### Applies To ###
+
+Project configurations
+
+### Availability ###
 
-When linking against another projects or libraries gcc/clang by default have order dependent linking, at least with the general default linker. While it is generally believed to be slower, you can enable order independent linking within a group of libraries by putting them inside of a link-group using the -Wl,--start-group and -Wl,--end-group command line arguments.
+Premake 5.0-alpha10 or later. GCC and Clang toolsets only. Codelite, gmake, and gmake2 exporters only.
+
+### Examples ###
+
+```lua
+project "A"
+    kind "StaticLib"
+
+project "B"
+    kind "StaticLib"
+    links { "A" }
+
+project "C"
+    kind "ConsoleApp"
+    links { "A", "B" }
+    linkgroups "On"
+```
 
-This API turns this grouping on or off (it is off by default), and applies to all libraries specified in the [links](links.md) API.
+### See Also ###
+* [links](links.md)