Bump npm package versions

docs/developer/README.md

@@ -128,15 +128,36 @@ type
 docker-compose run owasp
 ```
 
-## USWDS and styling
+# Images, stylesheets, and JavaScript
-We use the U.S. Web Design System (USWDS) for building and styling our applications. Additionally, we utilize the [uswds-compile tool](https://designsystem.digital.gov/documentation/getting-started/developers/phase-two-compile/) from USWDS  to compile and package the static assets.
+
+We use the U.S. Web Design System (USWDS) for styling our applications.
+
+Static files (images, CSS stylesheets, JavaScripts, etc) are known as "assets".
+
+Assets are stored in `registrar/assets` during development and served from `registrar/public`. During deployment, assets are copied from `registrar/assets` into `registrar/public`. Any assets which need processing, such as USWDS Sass files, are processed before copying.
+
+We utilize the [uswds-compile tool](https://designsystem.digital.gov/documentation/getting-started/developers/phase-two-compile/) from USWDS to compile and package USWDS assets.
+
+## Making and view style changes
+
 When you run `docker-compose up` the `node` service in the container will begin to watch for changes in the `registrar/assets` folder, and will recompile once any changes are made.
+
 Within the `registrar/assets` folder, the `_theme` folder contains three files initially generated by `uswds-compile`:
 1. `_uswds-theme-custom-styles` contains all the custom styles created for this application
 2. `_uswds-theme` contains all the custom theme settings (e.g. primary colors, fonts, banner color, etc..)
 3. `styles.css` a entry point or index for the styles, forwards all of the other style files used in the project (i.e. the USWDS source code, the settings, and all custom stylesheets).
 
-You can also compile the sass at any time using `npx gulp compile`. Similarly, you can copy over other static assets (images and javascript files), using `npx gulp copyAssets`.
+You can also compile the **Sass** at any time using `npx gulp compile`. Similarly, you can copy over **other static assets** (images and javascript files), using `npx gulp copyAssets`.
+
+## Upgrading USWDS and other JavaScript packages
+
+Version numbers can be manually controlled in `package.json`. Edit that, if desired.
+
+Now run `docker-compose run node npm update`.
+
+Then run `docker-compose up` to recompile and recopy the assets.
+
+Examine the results in the running application (remember to empty your cache!) and commit `package.json` and `package-lock.json` if all is well.
 
 ## Finite State Machines
 

src/package.json

@@ -10,7 +10,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@uswds/uswds": "^3.1.0",
+    "@uswds/uswds": "^3.3.0",
     "pa11y-ci": "^3.0.1",
     "sass": "^1.54.8"
   },