Rework Modules section

docs/FreeSWITCH-Explained/Installation/Linux/Vanilla-installation-files_27591294.mdx

@@ -52,8 +52,5 @@ General information, and security advice to consider before going live.
 
 ### 2.1 `./yaml/` 
 
-Seems to be created for people who complained regarding XML and/or wanted to use Asterisk style configuration. See this [FAQ entry](../../Miscellaneous/FAQ/index.mdx#q-xml-sucks-do-i-have-any-other-options).
-
-Committed by Anthony Minessale II in 2008 with commit message "[Yet Another Mega Labotomy](https://github.com/signalwire/freeswitch/commit/35dc909cf69191d51af26e26adb4d4d5bcbfcdaa)", and it hasn't been touched since. [mod\_yaml](../../Modules/mod_yaml_32178409.mdx) also hasn't been documented since 2008.
-
+See [<span class="fs-mod-names">mod_yaml</span>](../../Modules/mod_yaml_32178409.mdx).
 

docs/FreeSWITCH-Explained/Miscellaneous/FAQ/index.mdx

@@ -86,7 +86,7 @@
 * [Q: How do I use a single domain for the entire server](#q-how-do-i-use-a-single-domain-for-the-entire-server)
 * [Configuring FreeSWITCH](#configuring-freeswitch)  
 * [Q: Is there a GUI for configuring FreeSWITCH?](#q-is-there-a-gui-for-configuring-freeswitch)  
-* [Q: XML sucks! Do I have any other options?](#q-xml-sucks-do-i-have-any-other-options)
+* [Q: XML sucks! Do I have any other options?](#xml-sucks)
 
 
 ### Q: So where do I find wishlists for the developers of this awesome software?
@@ -541,19 +541,24 @@ If you want all registrations to be listed/stored at the same domain then: use f
 
 There are several free open source projects being actively maintained, an older abandoned one, and several commercial options. See [Freeswitch Gui](https://wiki.freeswitch.org/wiki/Freeswitch%5FGui "Freeswitch Gui")
 
-### Q: XML sucks! Do I have any other options?
+### Q: XML sucks! Do I have any other options? {#xml-sucks}
 
 Yes and no. There are other options, but they may not be _better_ options. The discussion about the use of XML in the FreeSWITCH configuration is plentiful. Check out these threads for some background:
 
 * [Anthony's explanation of why we chose XML](http://www.freeswitch.org/node/123) (dead link)  
-See [saved copy](https://web.archive.org/web/20130412200610/http://www.freeswitch.org/node/123) on Internet Archive or [XML it's not all bad.](./27591425.mdx)
-* [Anthony discusses creating mod\_yaml to prove a point](http://lists.freeswitch.org/pipermail/freeswitch-users/2008-June/004021.html)  
-[mod\_yaml](../../Modules/mod_yaml_32178409.mdx) not documented yet.
 
-See also [mod\_dialplan\_asterisk](https://wiki.freeswitch.org/wiki/Mod%5Fdialplan%5Fasterisk "Mod dialplan asterisk") for more information on configuring FreeSWITCH's dialplan using the extensions.conf INI-style configuration. (NOTE: this is less flexible and less powerful than using the XML configuration.) 
+  See [saved copy](https://web.archive.org/web/20130412200610/http://www.freeswitch.org/node/123) on Internet Archive or [XML it's not all bad.](./27591425.mdx)
 
-That all being said, if XML is the _only_ reason you're holding off from trying FreeSWITCH then we recommend you try it out with the default configuration and give it a test drive. You'll be surprised at how much you can do with a minimal amount of tinkering in the XML configs. And you'll be downright amazed at what you can do with a healthy amount of tinkering in the XML configs.
+* [Anthony discusses creating <span class="fs-mod-names">mod_yaml</span> to prove a point](http://lists.freeswitch.org/pipermail/freeswitch-users/2008-June/004021.html). (See also: [<span class="fs-mod-names">mod_yaml</span>](../../Modules/mod_yaml_32178409.mdx).)
 
-NOTE: Another way to program your call logic without using [Dialplan XML](https://wiki.freeswitch.org/wiki/Dialplan%5FXML "Dialplan XML") is to use [mod\_dptools](https://wiki.freeswitch.org/wiki/Mod%5Fdptools "Mod dptools") and/or [mod\_commands](https://wiki.freeswitch.org/wiki/Mod%5Fcommands "Mod commands") through [mod\_event\_socket](https://wiki.freeswitch.org/wiki/Mod%5Fevent%5Fsocket "Mod event socket") or [ESL](https://wiki.freeswitch.org/wiki/Event%5FSocket%5FLibrary "Event Socket Library"). This way you can avoid using Dialplan XML and you can do all your call logic from a compiled or interpreted programming language.
+* See also [<span class="fs-mod-names">mod_dialplan_asterisk</span>](../../Modules/mod_dialplan_asterisk) for more information on configuring FreeSWITCH's dialplan using the `extensions.conf`'s INI-style configuration.
 
+  :::warning
+  This is less flexible and less powerful than using the FreeSWITCH's XML configuration.) 
+  :::
 
+That all being said, if XML is the _only_ reason you're holding off from trying FreeSWITCH, then we recommend you try it out with the default configuration and give it a test drive. You'll be surprised at how much you can do with a minimal amount of tinkering in the XML configs. And you'll be downright amazed at what you can do with a healthy amount of tinkering in the XML configs.
+
+:::info
+Another way to program your call logic without using the [XML Dialplan](../../Dialplan/XML-Dialplan/) is to use [<span class="fs-mod-names">mod_dptools</span>](../../Modules/mod_dptools_1970333.mdx) and/or [<span class="fs-mod-names">mod_commands</span>](../../Modules/mod_commands_1966741.mdx) through [<span class="fs-mod-names">mod_event_socket</span>](../../Modules/mod_event_socket_1048924.mdx) or the [Event Socket Library (ESL)](../../Client-and-Developer-Interfaces/Event-Socket-Library/). This way you can avoid using the [XML Dialplan](../../Dialplan/XML-Dialplan/), and you can do all your call logic from a compiled or interpreted programming language.
+:::