Links for installing core tooling

.github/styles/config/vocabularies/Mautic/accept.txt

@@ -125,6 +125,7 @@ Unpublish
 URL
 URLs
 UTM
+VSCode
 Vtiger
 Webmecanik
 www

docs/links/colima_install.py

@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "install Colima" 
+link_text = "install Colima" 
+link_url = "https://github.com/abiosoft/colima?tab=readme-ov-file#installation" 
+
+link.xref_links.update({link_name: (link_text, link_url)})

docs/links/ddev_install.py

@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "install DDEV" 
+link_text = "install DDEV" 
+link_url = "https://ddev.readthedocs.io/en/stable/users/install/ddev-installation/" 
+
+link.xref_links.update({link_name: (link_text, link_url)})

docs/links/docker_desktop_install.py

@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "install Docker Desktop" 
+link_text = "install Docker Desktop" 
+link_url = "https://www.docker.com/products/docker-desktop/" 
+
+link.xref_links.update({link_name: (link_text, link_url)})

docs/links/git_download.py

@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "install Git" 
+link_text = "install Git" 
+link_url = "https://git-scm.com/downloads" 
+
+link.xref_links.update({link_name: (link_text, link_url)})

docs/links/github_cli_install.py

@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "install GitHub CLI" 
+link_text = "install GitHub CLI" 
+link_url = "https://cli.github.com/" 
+
+link.xref_links.update({link_name: (link_text, link_url)})

docs/links/vscode_install.py

@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "install VSCode" 
+link_text = "install VSCode" 
+link_url = "https://code.visualstudio.com/download" 
+
+link.xref_links.update({link_name: (link_text, link_url)})

docs/teams/education_team/contributing_docs_rst.rst

@@ -10,7 +10,7 @@ So you're interested in contributing to Mautic's documentation? That's fantastic
 Getting started
 ***************
 
-You can work with the documentation locally, using DDEV and an application like VSCode. This allows you to make changes and see them in real-time on a locally-hosted version of the documentation.
+You can work with the documentation locally, using DDEV and an editor like VSCode. This allows you to make changes and see them in real-time on a locally hosted version of the documentation. It's recommended as you can benefit from having syntax highlighting, and also generate the docs to verify the layout of your work as you go.
 
 You can also use the web-based tool :xref:`Gitpod`, which allows you to spin up a temporary cloud-hosted instance of the documentation, make changes, and submit a pull request to have your changes merged back into the main repository. You can also test PRs with Gitpod, too.
 
@@ -19,8 +19,10 @@ Working locally
 
 To get started with one of the documentation repositories locally, it's advised to install:
 
-- Git
-- Docker or Colima
-- DDEV 
-- VSCode
-- GitHub CLI
+- Git - :xref:`install Git`
+- Docker Desktop - All operating systems, :xref:`install Docker Desktop` - or Colima - Mac and Linux, :xref:`install Colima`
+- DDEV - :xref:`install DDEV`
+- VSCode - :xref:`install VSCode`
+- GitHub CLI - :xref:`install GitHub CLI`
+
+