address review comment

Author: i-am-sijia

docs/dev-guide/install.md

@@ -4,7 +4,7 @@
 Installing ActivitySim as a developer is as easy as just using it with *uv*.
 
 Depending on what you are working on, you may want to check out a branch
-other than the default `master`. To do so, you can use a `git switch` command
+other than the default `main`. To do so, you can use a `git switch` command
 to any other existing branch name. If you want to start an new
 branch, first create it with `git branch cool-new-feature` and then switch
 to it with `git switch cool-new-feature`.

docs/users-guide/modelsetup.rst

@@ -90,7 +90,7 @@ There are two recommended ways to install ActivitySim:
 
 1. Using a :ref:`pre-packaged installer`
 
-2. Using :ref:`Python the uv package and project manager`
+2. Using the :ref:`UV Package and Project Manager`
 
 The first is recommended for users who do not need to change the Python code and are on Windows, 
 and the second is recommended for users who need to change/customize the Python code.
@@ -121,7 +121,7 @@ Once the install is complete, ActivitySim can be run directly from any command
 prompt by running `<install_location>/Scripts/ActivitySim.exe`.
 
 
-Using *uv* package and project manager
+UV Package and Project Manager
 ______________________________________
 
 This method is recommended for ActivitySim users who are familiar with 
@@ -220,7 +220,21 @@ and then run code.
 `here <https://docs.astral.sh/uv/getting-started/installation/>`_. (Skip
 if already installed above. It only needs to be installed once per machine.)
 
-2. Clone the ActivitySim project using Git. (If Git is not installed, 
+.. note::
+  If you already have *uv* installed from an older project and you encounter errors
+  such as 
+  ::
+
+    error: Failed to parse uv.lock... missing field version...
+  
+  later in the process, you may need to update *uv* to the latest version by reinstalling it via the official
+  installation script: https://docs.astral.sh/uv/getting-started/installation/#standalone-installer.
+  You can check the version of *uv* you have installed by running
+  ::
+
+    uv --version
+
+1. Clone the ActivitySim project using Git. (If Git is not installed, 
 instructions can be found `here <https://git-scm.com/downloads>`_.)
 
 ::