Updated note format using MyST Admonition (#289)

* Update fax_server.md

* Update operator_panel.md

* Update recordings.md

* Update recordings.md

* Update streams.md

* Update voicemail.md

* Update voicemail_transcription.md

* Update restore.md

* Update upgrade.md

* Update software_utilities.md

* Update password_reset.md

* Update provision.md

* Update version_upgrade.md

* Update cdr_archive.md

* Update contributing.md

* Update xmpp.md

* Update webrtc.md

* Update software_utilities.md

source/additional_information/cdr_archive.md

@@ -1,11 +1,13 @@
 # CDR Archive Server
 
-\* Note: This feature is on version 4.5+ and requires PostgreSQL ver
-9.5+ \| Fusionpbx has the ability to access CDR records on a seperate
+:::{note}
+
+This feature is on version 4.5+ and requires PostgreSQL ver
+9.5+ | Fusionpbx has the ability to access CDR records on a seperate
 archive database. This is helpful for longterm CDR storage while keeping
 your active database small. When the feature is enabled you will see an
-\"ARCHIVE\" button in CDR page that accesses records on your archive
-database.
+"ARCHIVE" button in CDR page that accesses records on your archive database.   
+:::
 
   The first step is to install an archive database. This can be done by
   standing up another fusionpbx server or by setting up a postgres
@@ -93,9 +95,13 @@ database.
     15 0 * * * bash /etc/cron.daily/db_copy.sh
 ```
 
--   Note: In this example I remove the json data from the records. You
-    will need to comment out the \"SET json = NULL\" line if you want to
-    keep the call variables.
+:::{note}
+
+In this example I remove the json data from the records. You
+will need to comment out the \"SET json = NULL\" line if you want to
+keep the call variables.   
+:::
+
 
 ### [CDR](default_settings/cdr.html)
 

source/additional_information/password_reset.md

@@ -26,8 +26,10 @@ make a new superadmin user name and password.
 ```
 <br>
 
-Note: In older installations of FusionPBX config.php is located in
-/var/www/fusionpbx/resources/
+:::{note}
+
+In older installations of FusionPBX config.php is located in /var/www/fusionpbx/resources/
+:::
 
 <br>
 

source/advanced/upgrade.md

@@ -106,14 +106,22 @@ Used to update FusionPBX to the latest release.
 
 ### Step 2: Update Freeswitch Scripts
 
-  **Note:** As of FusionPBX 3.8.3 (Stable Branch), the scripts should be
-  automatically updated when updating the Source Code, using the
-  **Advanced \> Upgrade** page. Any customized scripts, having the same
-  name as the default scripts, **will be overwritten.** (An option to
-  disable this default behavior is available using **Default Setting:
-  switch \> scripts_update \> false**) Missing scripts will be restored,
-  and any additional files within the scripts folder will remain
-  untouched.
+:::{note}
+
+As of FusionPBX 3.8.3 (Stable Branch), the scripts should be
+automatically updated when updating the Source Code, using the
+**Advanced** > **Upgrade** page. Any customized scripts, having the same
+name as the default scripts, **will be overwritten.** 
+:::
+
+:::{tip}
+
+An option to
+disable this default behavior is available using **Default Setting:
+switch > scripts_update > false**. Missing scripts will be restored,
+and any additional files within the scripts folder will remain
+untouched.   
+:::
 
   FusionPBX is a fast moving project where features are constantly being
   added and bugs are being fixed on a daily basis so I would also
@@ -124,8 +132,12 @@ Used to update FusionPBX to the latest release.
     - Use github to get the updated files. **You have to do this from an
   empty directory**.
 
-**Note:** Older versions of FusionPBX may use the /usr/local path instead of /usr/share
+:::{note}
+
+Older versions of FusionPBX may use the /usr/local path instead of /usr/share   
+:::
 
+```
     cp -R /usr/share/freeswitch/scripts /usr/share/freeswitch/scripts-bak
     rm -Rf /usr/share/freeswitch/scripts/
     cd /usr/src
@@ -135,6 +147,7 @@ Used to update FusionPBX to the latest release.
 
     # (The last step above is not required if your config.lua file is being stored in a different location, such as the /etc/fusionpbx folder.)
     cp -R /usr/share/freeswitch/scripts-bak/resources/functions/config.lua /usr/share/freeswitch/scripts/resources/functions/config.lua
+```
 
 - Clean out this scripts directory
      - An alternative is to remove the Lua scripts. **Only do this if you
@@ -192,7 +205,7 @@ Used to update FusionPBX to the latest release.
   no theme, it is because you were using a theme which no longer exists
   in the latest version of the code. If this happens to you navigate to:
 
-    http://domain_or_ip/mod/users/usersupdate.php
+- http://domain_or_ip/mod/users/usersupdate.php
 
   Then scroll down to where it says **\"Template\"** and select one of
   the valid templates from the drop down list. Then press Save. It will
@@ -234,10 +247,13 @@ Needed if your menu disappeared.
 
 ### Step 6: Re-generate Settings
 
-  **Note:** Sometimes variable names changes. In rev 1877 **v_config_cli.php**
-  variable names changed which caused no fax to email emails or
-  voicemail emails to be sent. Problem was the SMTP details did not
-  exist.
+:::{note}
+
+Sometimes variable names changes. In rev 1877 **v_config_cli.php**
+variable names changed which caused no fax to email emails or
+voicemail emails to be sent. Problem was the SMTP details did not
+exist.
+:::
 
 - Go to Advanced -> Settings and then click save. This will re-generate v_config_cli.php and any other needs config files.
 

source/advanced/version_upgrade.md

@@ -85,9 +85,12 @@ openai - elevenlabs
 These instructions for upgrade are also relevant to versions of   
 FusionPBX 5.1.0 and higher.
 
-> **Release Note:** When this upgrade.php is run from the root, it will   
-> write the /etc/fusionpbx/config.conf file by reading information from   
-> the database and config.php and config.lua.
+:::{note}
+
+When this upgrade.php is run from the root, it will   
+write the /etc/fusionpbx/config.conf file by reading information from   
+the database and config.php and config.lua.   
+:::
 
 - Run (Install) Upgrades
 
@@ -112,9 +115,12 @@ FusionPBX 5.1.0 and higher.
     systemctl restart event_guard
 ```
 
-> **Note:** If the fax[queue]{#queue} is not installed it will show an error.   
-> This is only a problem if you are using fax. If you are using fax then   
-> you will want to install the fax[queue]{#queue} service.
+:::{note}
+
+If the fax[queue]{#queue} is not installed it will show an error.   
+This is only a problem if you are using fax. If you are using fax then   
+you will want to install the fax[queue]{#queue} service.   
+:::
 
 ```
     cp /var/www/fusionpbx/app/fax_queue/resources/service/debian.service /etc/systemd/system/fax_queue.service
@@ -189,9 +195,12 @@ To manually update the menu, you need to edit the default menu.
 These instructions for upgrade are also relevant to versions of   
 FusionPBX 5.0.3 to 5.0.10 and higher.
 
-> **Release Note:** When this upgrade.php is run from the root, it will write the   
-> /etc/fusionpbx/config.conf file by reading information from the database   
-> and config.php and config.lua.
+:::{note}
+
+When this upgrade.php is run from the root, it will write the   
+/etc/fusionpbx/config.conf file by reading information from the database   
+and config.php and config.lua.   
+:::
 
 - Run (Install) Upgrades
 
@@ -395,9 +404,12 @@ Confirm that the values have been updated using this command.
 - Refresh the browser if there are issues then logout and then back in.
 - Update the following Dialplans.
 
-> **Note:** If you have made any changes, make notes before you delete them.   
-> So changes can be added back. For example, valet park could have custom   
-> music on hold or a custom timeout for the valet park.
+:::{note}
+
+If you have made any changes, make notes before you delete them.   
+So changes can be added back. For example, valet park could have custom   
+music on hold or a custom timeout for the valet park.   
+:::
 
 ```
     user_exists
@@ -526,9 +538,12 @@ the correct preset UUID\>
     chown -R www-data:www-data /var/www/fusionpbx
 ```
 
-> **Note:** Depending on when you installed the path /etc/fusionpbx might need   
-> created. A good way to tell is once you move the fusionpbx folder in   
-> step one and the FusionPBX is on a page with flags.
+:::{note}
+
+Depending on when you installed the path /etc/fusionpbx might need   
+created. A good way to tell is once you move the fusionpbx folder in   
+step one and the FusionPBX is on a page with flags.   
+:::
 
 <br>
 
@@ -544,11 +559,13 @@ the correct preset UUID\>
 -   Then go to **Advanced** -> **Upgrade** and run **Source Code**, **Schema**,   
     **Menu Defaults** and **Permission Defaults**.
 
+:::{note}
 
-> **Note:** config.lua needs to be read and write by the webserver in order   
-> for advanced default settings to update config.lua with new path information.   
-> Make sure config.lua and config.php are in /etc/fuionpbx/ .   
-> And be sure to run this command. 
+config.lua needs to be read and write by the webserver in order   
+for advanced default settings to update config.lua with new path information.   
+Make sure config.lua and config.php are in /etc/fuionpbx/ .   
+And be sure to run this command.    
+:::
 
 ```
 chown -R www-<data:www-data> /etc/fusionpbx/
@@ -593,9 +610,12 @@ Changes have been made in the **Email** section in **Advanced** -> **Default set
 -   Don't delete the blank entries. The code behind them are for   
     version 4.4+ and the original ones are not.
 
-> **Note:** If you already deleted the blank ones, you'll have to delete the email   
-> section, run App Defaults under **Advanced** -> **Upgrade**. Then navigate   
-> back to **Advanced** -> **Default settings** and set the email section back up.
+:::{note}
+
+If you already deleted the blank ones, you'll have to delete the email   
+section, run App Defaults under **Advanced** -> **Upgrade**. Then navigate   
+back to **Advanced** -> **Default settings** and set the email section back up.   
+:::
 
 <br>
 
@@ -685,9 +705,12 @@ Next steps are for existing Time Conditions.
     Select the holidays over again.
 
 
-> **Note:** Many of the provisioning templates were updated.   
-> If you use custom provisioning templates you should consider   
-> updating them with the new versions.
+:::{note}
+
+Many of the provisioning templates were updated.   
+If you use custom provisioning templates you should consider   
+updating them with the new versions.   
+:::
 
 <br>
 
@@ -711,10 +734,12 @@ Rebooting FreeSWITCH is required for this to take effect.
 
 ## Version 3.6 to 3.8
 
-> **Note:** Upgrading can get very complex. If the production system is   
-> critical or you are intimidated from these upgrade instructions you   
-> may want FusionPBX paid support at   
-> http://www.fusionpbx.com/support.php
+:::{note}
+
+Upgrading can get very complex. If the production system is   
+critical or you are intimidated from these upgrade instructions you   
+may want FusionPBX paid support at http://www.fusionpbx.com/support.php   
+:::
 
 A standard upgrade procedure should always be followed:
 
@@ -875,12 +900,15 @@ Groups and Permissions
 
 ## Version 3.5 to 3.6
 
-> **Note:** When running **Schema**   
-> If you see **ALTER TABLE v_xml_cdr ADD json json;** every time you run it, 
-> then you likely have an old version of Postgres. To fix this either
-> upgrade to the latest Postgres server or run the following
-> SQL statement from **Advanced** -> **SQL Query.**
-  
+:::{note}
+
+When running **Schema**   
+If you see **ALTER TABLE v_xml_cdr ADD json json;** every time you run it, 
+then you likely have an old version of Postgres. To fix this either
+upgrade to the latest Postgres server or run the following
+SQL statement from **Advanced** -> **SQL Query.**
+:::
+
 ```
     ALTER TABLE v_xml_cdr ADD json text;
 ```
@@ -933,7 +961,10 @@ See <https://github.com/fusionpbx/fusionpbx/issues/655> for more details.
 - Go To **Advanced -\> Group Manager**,   
   on **superadmin** click **Permissions** and then **Restore Default**
 
-> **Note:** You may need to execute this operation for each group.
+:::{note}
+
+You may need to execute this operation for each group.   
+:::
 
  **Default Settings**
  
@@ -1055,7 +1086,10 @@ See <https://github.com/fusionpbx/fusionpbx/issues/655> for more details.
   <https://github.com/fusionpbx/fusionpbx-scripts/tree/master/upgrade>
     - If greater than revision 1877, use latest.
 
-> **Note:** When upgrading from previous versions, you may encounter the following issues:
+:::{note}
+
+When upgrading from previous versions, you may encounter the following issues:    
+:::
 
 - **Changes to your dial plan or extensions don\'t take effect**   
 - Go to the **Advanced -\> Default Settings** page   

source/applications/fax_server.md

@@ -26,8 +26,13 @@ There are more settings for fax under **Advanced** \> **Default Settings** then
 
 To create a fax server goto **Applications** \> **Fax Server**. Click the "**ADD**" button on the right.
 
-> **Note:** Make sure you leave the **Destination Number** blank or faxing wont work. All fields in **bold** are required.   
-> It is also good practice accross FusionPBX to stay organized, so define the name and chosen extension thoughtfully.
+:::{note}
+Make sure you leave the **Destination Number** blank or faxing wont work. All fields in **bold** are required.   
+:::
+
+:::{tip}
+It is good practice accross FusionPBX to stay organized, so define the name and chosen extension thoughtfully.
+:::
 
 -   **Account Code**: This item will autofill. 
 -   **Destination Number**: This is used in the Fax Server Dial Plan and is set

source/applications/operator_panel.md

@@ -16,12 +16,11 @@ are set to the user.
 
 ![image](../_static/images/applications/fusionpbx_operator_panel.jpg)
 
-:::: note
-<p class="admonition-title">Note</p>
+:::{note}
 
 Make sure in Accounts \> Extensions that the extension is assigned to
 the user. This will enable Operator Panel for that user.
-::::
+:::
 
 ## Operator Panel Status
 

source/applications/provision.md

@@ -58,12 +58,10 @@ on.
 -   [Screen
     Capture](https://docs.fusionpbx.com/en/latest/applications/provision/phone_screen_capture.html)
 
-:::: note
-<p class="admonition-title">Note</p>
+:::{note}
 
-[Click here to view how to add a
-device](../accounts/devices.md).
-::::
+[Click here to view how to add a device](../accounts/devices.md).   
+:::
 
 ## Phone Book
 

source/applications/recordings.md

@@ -12,15 +12,12 @@ video.](https://youtu.be/CkqlsVvvv2U)
 <iframe width="100%" height="350" src="https://www.youtube.com/embed/CkqlsVvvv2U?rel=0" frameborder="0" ; encrypted-media" allowfullscreen></iframe>
 </div>
 
-To view and set the pin number goto Dialplan > Dialplan Manager > Click on Recordings > pin_number=8675309 at the bottom.
+To view and set the pin number goto **Dialplan** > **Dialplan Manager** > Click on **Recordings** > **pin_number=8675309** at the bottom.
 
-:::: note
-::: title
-Note
-:::
+:::{note}
 
-Pin number is recomended but can be left empty if no pin number is desired then pin_number=
-::::
+Pin number is recomended but can be left empty if no pin number is desired then pin_number=   
+:::
 
 ## Create a Recording
 

source/applications/streams.md

@@ -21,15 +21,19 @@ Define details for streaming audio.
 
 ![image](../_static/images/applications/streams/fusionpbx_streams2.png)
 
->**Note:**   
->Editing a stream path will result in having to update anything that is   
->using the stream. For example, if you have extension 500 using stream   
->\"Local Weather\" and you edit the shout:// path then you will have to   
->go back to extension 500 and reset the music on hold for extension 500.   
->This is by design.
+:::{note}
 
+Editing a stream path will result in having to update anything that is   
+using the stream.   
+:::
 
+For example, if you have extension **500** using stream   
+"**Local Weather**" and you edit the **shout://** path then you will have to   
+go back to extension **500** and reset the music on hold for extension **500**.   
+This is by design.
 
->**Warning:**   
->Please be aware of your countries copyright laws for streaming the   
->content you are going to stream.   
+:::{warning}
+
+Please be aware of your countries copyright laws for streaming the   
+content you are going to stream.   
+:::

source/applications/voicemail.md

@@ -18,7 +18,11 @@ Here you can edit voicemail settings:
 
 ![Voicemail Settings Continued](../_static/images/voicemail/fusionpbx_voicemail2.jpg)
 
-> **Note**: Starting version 4.2, remote access to voicemail by interrupting the greeting message by pressing "*" and entering the password is disabled by default.
+:::{note}
+
+Starting version 4.2, remote access to voicemail by interrupting the greeting message   
+by pressing "*" and entering the password is disabled by default.   
+:::
 
 To enable remote access to voicemail:
 
@@ -80,7 +84,10 @@ Using switch variables provides the ability to adjust FusionPBX Voicemail featur
 | vm_say_caller_id_number   | true or false  |
 | vm_say_date_time          | true or false  |
 
-> **Note**: 'wav' format is the default voicemail message file type. A value of 'mp3' requires *mod_shout* be installed and running.
+:::{note}
+
+The 'wav' format is the default voicemail message file type. A value of 'mp3' requires *mod_shout* be installed and running.   
+:::
 
 ### Not Found Message
 When an extension is unavailable and no voicemail is configured, there is an option to play a message to the caller alerting them to this.

source/applications/voicemail_transcription.md

@@ -63,7 +63,10 @@ Uses API services to transcribe voicemails into text for use in the app-sms and
 ## IBM Watson API
 Sign up and language information is located on [IBM Watson's Site](https://cloud.ibm.com/catalog/services/speech-to-text).
 
-> **Warning**: We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
+:::{warning}
+
+We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
+:::
 
 **Go to Advanced > Default Settings.**  
 Add the following entries:
@@ -77,8 +80,11 @@ Add the following entries:
 | voicemail | transcribe_enabled   | boolean| true               | True    |
 | voicemail | json_enabled         | boolean| true               | True    |
 
-*NOTE: Watson URL used for testing was:  
+:::{note}
+
+Watson URL used for testing was:   
 https://example.url.api.us-south.speech-to-text.watson.cloud.ibm.com/instances/{GUID}/v1/recognize?model=en-US_Telephony&smart_formatting=true*
+:::
 
 **List of available IBM Watson speech-to-text models**:  
 [https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models)
@@ -136,7 +142,10 @@ Recommend using Azure as an alternative to Bing.
 Sign up and language information is located on [Microsoft Site](https://www.microsoft.com/cognitive-services/en-us/Speech-api/documentation/API-Reference-REST/BingVoiceRecognition).  
 Note: The Bing Speech API is deprecated as of October 2018; this works for now but needs to be ported to [the new API](https://github.com/MicrosoftDocs/azure-docs/blob/master/articles/cognitive-services/Speech-Service/how-to-migrate-from-bing-speech.md).
 
-> **Warning**: We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
+:::{warning}
+
+We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
+:::
 
 **Go to Advanced > Default Settings.**  
 Add the following entries:

source/applications/xmpp.md

@@ -11,20 +11,21 @@ XMPP Manager there are a few step to take to enble XMPP.
 -   Accounts -\> XMPP manager.
 -   Click the **plus** on the right to create a profile.
 
-:::: note
-<p class="admonition-title">Note</p>
+:::{note}
 
-Google has since depricated xmpp service
-::::
+Google has since depricated xmpp service.   
+:::
 
 In this example we will setup Google Talk and by creating a profile
 called gtalk.
 
+```
     Profile Name: gtalk
     Username: [email protected] (use your account)
     Password: use the correct password
     Auto-Login: yes
     XMPP Server: talk.google.com
+```
 
 ![image](../_static/images/fusionpbx_xmpp2.jpg)
 
@@ -36,8 +37,10 @@ Lets say my gmail number was 13051231234. This approach will send the
 inbound calls to the inbound routes with a destination number that is
 the default extension number that is set.
 
+```
     Default extension: 13051231234
     Advanced -> Context: public
+```
 
 **Option 2.**
 
@@ -52,16 +55,21 @@ the default context.
 On a single tenant system. This will send the call to extension 1001 in
 the multi-tenant domain name.
 
+```
     Default extension: 1001
     Advanced -> Context: your.domain.com
+```
 
 Save the settings and restart the module. Restart the \'XMPP\' module
 from Advanced -\> Modules page. Go back to Accounts -\> XMPP if the
 status says **\'AUTHORIZED\'** then you are ready to go.
 
-**Note** If you are not getting AUTHORIZED you might need to goto the
+:::{note}
+
+If you are not getting AUTHORIZED you might need to goto the
 google account settings and choose \"Allow less secure apps: ON\" under
-the Sign-in & security section.
+the Sign-in & security section.   
+:::
 
 ![image](../_static/images/fusionpbx_xmpp5.jpg)
 
@@ -69,10 +77,12 @@ the Sign-in & security section.
 
 For this example we will use 11 digit dialing.
 
+```
     Gateway: XMPP
     Dialplan Expression: 11 digits
     Description: Google Talk
     Press Save
+```
 
 If your XMPP profile is named something other than gtalk edit the
 outbound route you just created. Bridge statement should look like:
@@ -91,12 +101,14 @@ After version 3.8 XMPP is optional. To add XMPP do the following
 
 Goto command line
 
+```
     cd /tmp
     git clone https://github.com/fusionpbx/fusionpbx-apps.git 
     cd fusionpbx-apps/
     mv xmpp/ /var/www/fusionpbx/app/
     cd /var/www/fusionpbx/app
     chown www-data:www-data -R xmpp/
+```
 
 Goto Fusionpbx GUI
 

source/applications_optional/webrtc.md

@@ -4,14 +4,13 @@ WebRTC is a technology combined with WebSockets makes it possible to use
 a browser based as a SIP Client. Also, keep in mind that you will need
 SSL certs working on the server.
 
-:::: note
-<p class="admonition-title">Note</p>
+:::{note}
 
 There are two \"sets\" of code in this app. One being an existing app
 from FusionPBX and the code example from [Master FreeSWITCH
 book](https://www.packtpub.com/networking-and-servers/mastering-freeswitch)
-in Chapter 8.
-::::
+in Chapter 8.   
+:::
 
 ## Install Steps
 

source/contributing.md

@@ -10,10 +10,13 @@ There are many ways to help the FusionPBX project.
 4. Quality Assurance Testers
 5. Documentors
 
-> **Note:** If you are planning to contribute to any of our GitHub repos, we require that you sign   
-> the FusionPBX Contributor License Agreement. This mainly protects FusionPBX and our users **(read: you)**   
-> from code that could be inserted that might pose a legal problem. It does this by verifying the code you're   
-> contributing is yours to give and that you give it freely and irrevocably to the project.
+:::{note}
+
+If you are planning to contribute to any of our GitHub repos, we require that you sign   
+the FusionPBX Contributor License Agreement. This mainly protects FusionPBX and our users **(read: you)**   
+from code that could be inserted that might pose a legal problem. It does this by verifying the code you're   
+contributing is yours to give and that you give it freely and irrevocably to the project.   
+:::
 
 ## How to Get Started
 
@@ -28,8 +31,11 @@ There are many ways to help the FusionPBX project.
 4. Would you like to see FusionPBX in your native language and have the time to commit to staying on top of translations for releases?   
    Check out the translation section to learn how to use our translation server.
 
-> **Note:** Contributing code or documentation requires knowledge of Git, GitHub, and how to create pull requests on GitHub.   
-> This is not as bad as it sounds, and if you are willing to learn, we will help you through it.
+:::{note}
+
+Contributing code or documentation requires knowledge of Git, GitHub, and how to create pull requests on GitHub.   
+This is not as bad as it sounds, and if you are willing to learn, we will help you through it.   
+:::
 
 ## Table of Contents
 

source/getting_started/restore.md

@@ -5,10 +5,12 @@
 It's always good to have a restore method of a backup in place.    
 Here are the steps to a basic restore method with FusionPBX.
 
->**Note:**
->It is important to know if your installation is from package or source   
->as the paths are different for FreeSWITCH. Always test the backups and   
->restore methods on test machines first.
+:::{note}
+
+It is important to know if your installation is from package or source   
+as the paths are different for FreeSWITCH. Always test the backups and   
+restore methods on test machines first.   
+:::
 
 -   To create the script use an editor such as vi or nano.
 -   Copy/Paste from the code block below and save the file as

source/getting_started/software_utilities.md

@@ -15,13 +15,12 @@ issues and guage quality. Below are a list of some of the common ones.
 
     tcpdump -nq -s 0 -A -vvv -i eth0 port 5060
 
-:::: tip
-<p class="admonition-title">Tip</p>
+:::{tip}
 
-you can change the command to suite the proper ethernet device eth0 with
-what is on your system. Port 5060 can be changed also if you are using a
-different port.
-::::
+you can change the command to suite the proper ethernet device eth0 with   
+what is on your system. Port 5060 can be changed also if you are using a   
+different port.   
+:::
 
 ### [sngrep](../additional_information/sngrep.html)
 
@@ -56,15 +55,17 @@ and make reports is a very needed tool.
 Homer is well known to help track and graph quality issues with SIP,
 like utilizing QoS Reports.
 
-Quote:
-
-> *HOMER is a robust, carrier-grade, scalable SIP Capture system and
-> VoiP Monitoring Application offering HEP/EEP, IP Proto4 (IPIP)
-> encapsulation & port mirroring/monitoring support right out of the
-> box, ready to process & store insane amounts of signaling, logs and
-> statistics with instant search, end-to-end analysis and drill-down
-> capabilities for ITSPs, VoIP Providers and Trunk Suppliers using SIP
-> signaling protocol.*
+:::{admonition} Quote
+:class: seealso
+
+*HOMER is a robust, carrier-grade, scalable SIP Capture system and
+VoiP Monitoring Application offering HEP/EEP, IP Proto4 (IPIP)
+encapsulation & port mirroring/monitoring support right out of the
+box, ready to process & store insane amounts of signaling, logs and
+statistics with instant search, end-to-end analysis and drill-down
+capabilities for ITSPs, VoIP Providers and Trunk Suppliers using SIP
+signaling protocol.*   
+:::
 
 To install and configure Homer visit
 <https://github.com/sipcapture/homer>