update scripts doc

Author: outofambit

docs/scripts.md

@@ -1,16 +1,16 @@
-# Scripts
+# Content Scripts
 
 This repo includes a few scripts to pull content from external sources, primarily the [p5.js repo](https://github.com/processing/p5.js).
 
 They are all runnable via npm scripts.
 
-## Search Indices Build Script
+## After a p5.js release
 
-`npm run build:search` generates metadata about the content of the website so the search functionality can show relevant results.
+To update the content on the p5.js website following a new release of p5.js, you should run all of these commands to pull in the latest content. **Be sure to run the search indices script last as it depends on the results of the other scripts to be accurate.**
 
 ## Contributor Docs Build Script
 
-`npm run build:contributor-docs` copies the contributor docs from the p5.js website repo and places them into the [contributor docs content collection](/src/content/contributor-docs).
+`npm run build:contributor-docs` copies the contributor docs from the p5.js repo and places them into the [contributor docs content collection](/src/content/contributor-docs).
 
 ## Reference Build Script
 
@@ -19,3 +19,7 @@ They are all runnable via npm scripts.
 ## Contributors List Build Script
 
 `npm run build:contribtuors` parses the list of contributors from the all contributors [config file](https://github.com/processing/p5.js/blob/main/.all-contributorsrc) in the p5.js repo and adds entries in the [people collection](src/content/people/en) for anyone who is missing. These are used to render the list of contributors on the [People page](https://p5js.org/people/). This script will **not** remove or update existing entries, that must be done manually.
+
+## Search Indices Build Script
+
+`npm run build:search` generates metadata about the content of the website so the search functionality can show relevant results. This script should usually be run after any of the above scripts are run.