minor tweaks #10606

Author: pdurbin

doc/sphinx-guides/source/developers/dev-environment.rst

@@ -18,7 +18,7 @@ After cloning the `dataverse repo <https://github.com/IQSS/dataverse>`_, run thi
 
 ``mvn -Pct clean package docker:run``
 
-(Note that if you are Windows, you must run the command above in `WSL <https://learn.microsoft.com/windows/wsl>`_ rather than cmd.exe.)
+(Note that if you are Windows, you must run the command above in `WSL <https://learn.microsoft.com/windows/wsl>`_ rather than cmd.exe. See :doc:`windows`.)
 
 After some time you should be able to log in:
 

doc/sphinx-guides/source/developers/windows.rst

@@ -2,20 +2,21 @@
 Windows Development
 ===================
 
-
+.. contents:: |toctitle|
+       :local:
 
 Running Dataverse in Windows WSL
 --------------------------------
 
 The simplest method to run Dataverse in Windows 10 and 11 is using Docker and Windows Subsystem for Linux (WSL) - specifically WSL 2. 
-Once Docker and WSL are installed, you can follow the :ref:`Quickstart instructions <container-dev-quickstart>`.
+Once Docker and WSL are installed, you can follow the :ref:`quickstart instructions <container-dev-quickstart>`.
 
 Please note: these instructions have not been extensively tested. They have been found to work with the Ubuntu-24.04 distribution for WSL. If you find any problems, please open an issue at https://github.com/IQSS/dataverse/issues and/or submit a PR to update this guide.
 
 Install Docker Desktop
 ~~~~~~~~~~~~~~~~~~~~~~
 
-Follwow the directions at https://www.docker.com/ to install Docker Desktop on Windows. If prompted, turn on WSL 2 during installation.
+Follow the directions at https://www.docker.com to install Docker Desktop on Windows. If prompted, turn on WSL 2 during installation.
 
 Settings you may need in Docker Desktop:
 
@@ -29,7 +30,7 @@ Install WSL
 ~~~~~~~~~~~
 If you install Docker Desktop, you should already have WSL installed. If not, or if you wish to add an additional Linux distribution, open PowerShell.
 
-If wsl itself is not installed run:
+If WSL itself is not installed run:
 
 .. code-block:: powershell
   
@@ -61,20 +62,19 @@ You will be asked to create an initial Linux user.
 Install Dataverse
 ~~~~~~~~~~~~~~~~~
 
-Open a Linux terminal (e.g. use Windows Terminal and open a tab for the Linux distribution you selected). Then install Dataverse in WSL following the ``Quickstart`` instructions in :doc:`dev-environment`. You should then have a working Dataverse instance.
+Open a Linux terminal (e.g. use Windows Terminal and open a tab for the Linux distribution you selected). Then install Dataverse in WSL following the :ref:`quickstart instructions <container-dev-quickstart>`. You should then have a working Dataverse instance.
 
 IDEs for Dataverse in Windows
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can use your favorite editor or IDE to edit Dataverse project files. Files in WSL are accessible from Windows for editing using the path ``\\wsl.localhost``. Your Linux distribution files should also be visible in File Explorer under the This PC/Linux entry.
 FYI: For the best performance, it is recommended, with WSL 2, to store Dataverse files in the WSL/Linux file system and to access them from there with your Windows-based IDE (versus storing Dataverse files in your Windows file system and trying to run maven and build from Linux - access to /mnt/c files using WSL 2 is slow).
 
-
 pgAdmin in Windows for Dataverse
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can access the Dataverse database from Windows.
 
 Install pgAdmin from https://www.pgadmin.org/download/pgadmin-4-windows/
 
-In pgAdmin, register a server using ``127.0.0.1`` with port ``5432``, database ``dvndb``, and, by default, username ``dataverse`` password ``secret``. Now you will be able to access, monitor, and update the Dataverse database.
+In pgAdmin, register a server using ``127.0.0.1`` with port ``5432``. For the database name, username, and password, see :ref:`db-name-creds`. Now you will be able to access, monitor, and update the Dataverse database.