added inline descriptions to justfile

README.md

@@ -19,7 +19,8 @@ Govdirectory is a static site meaning that it already has all of its pages gener
 Because each initial build of Snowman issues thousands (yes thousands) of SPARQL queries one should never make an **initial** build against `query.wikidata.org` but rather against a local Wikidata Query Service (WDQS) instance. However, because setting up a WDQS instance is nontrivial we provide a copy of a [Snowman build cache directory](https://github.com/govdirectory/website-cache). If in use, this will ensure Snowman only queries Wikidata when a query is updated.
 
 > [!TIP]
-> Some of the most common development commands are available through our [Justfile](https://github.com/casey/just)
+> Some of the most common development commands are available through [Just](https://github.com/casey/just), if you do not use just you can still look in the `justfile` for hints.
+>
 
 ### Prerequisites
 

justfile

@@ -1,18 +1,23 @@
 @_default:
         just --list
 
+# build the full project
 build:
         snowman build --timeit
 
+# build the full project and once done, start the development server
 build-serve:
         snowman build --timeit && snowman server
 
+# only update the static files of the last build
 build-static:
         snowman build --static
 
-clear-query-cache:
+# clear all queries from the cache
+clear-cache:
         snowman cache --invalidate
 
+# setup a new cache from our remote cache repository
 bootstrap-cache:
         git clone https://github.com/govdirectory/website-cache .snowman