Add more comments

Author: jlchilders11

core/templatetags/custom_static.py

@@ -6,6 +6,12 @@
 
 @register.simple_tag
 def large_static(file_path: str):
+    """
+    Automatically handles serving large static content based on development vs. production.
+
+    Serves specified content from the local large static file is LOCAL_DEVELOPMENT is True, else serves
+    from the static content in S3.
+    """
     # Strip any leading slashes to avoid footguns
     file_path = file_path.lstrip("/")
     if settings.LOCAL_DEVELOPMENT:

justfile

@@ -184,7 +184,12 @@ alias shell := console
     docker compose run --rm web python manage.py {{ args }}
 
 # Static File Management
-@down_sync_images BUCKET='stage.boost.org.v2': ## syncs all items from specified bucket to static/static-large for local development
+@down_sync_images BUCKET='stage.boost.org.v2': ## syncs all items from specified bucket to static/static-large for local development. See scripts/upload-images.sh for required vars.
+    if ! command -v aws &>/dev/null; then \
+        echo "awscli is required. Please install it from https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html"; \
+        exit 1; \
+    fi
+
     if echo {{VALID_BUCKETS}} | grep -q -w '{{BUCKET}}'; then \
         aws s3 sync s3://{{BUCKET}}/static/  static/static-large/; \
         echo "All missing or outdated static items synced."; \