diff --git a/web/.gitignore b/web/.gitignore
index 94d2c19f5..0046043bd 100644
--- a/web/.gitignore
+++ b/web/.gitignore
@@ -9,8 +9,7 @@ node_modules/
 
 # Local env files
 .env
-.env.local
-.env.*.local
+.env*.local
 
 # Next.js
 .next/
diff --git a/web/apps/payments/README.md b/web/apps/payments/README.md
index c6a370c03..568437afd 100644
--- a/web/apps/payments/README.md
+++ b/web/apps/payments/README.md
@@ -1,4 +1,4 @@
-Code that runs on `payments.ente.io`, handling and web facing interaction with
+Code that runs on `payments.ente.io`. It brokers between our services and
 Stripe's API for payments.
 
 ## Development
@@ -32,7 +32,8 @@ NEXT_PUBLIC_STRIPE_US_PUBLISHABLE_KEY = stripe_publishable_key
 
 2. Define this secret within your `musuem.yaml`
 
-3. Update the `whitelisted-redirect-urls` so that it supports redirecting to this locally running project
+3. Update the `whitelisted-redirect-urls` so that it supports redirecting to
+   this locally running project.
 
 Assuming that your local payments app is running on `192.168.1.2:3001`, your
 `museum.yaml` should look as follows.
diff --git a/web/apps/photos/.env.development b/web/apps/photos/.env.development
index 34cf40a88..891e62180 100644
--- a/web/apps/photos/.env.development
+++ b/web/apps/photos/.env.development
@@ -1,7 +1,7 @@
 # Sample configuration file
 #
 # All variables are commented out by default. Copy paste this into a new file
-# called `.env.local` (or create a new file with that name) and add the
+# called `.env.local` (or create a new empty file with that name) and add the
 # environment variables you want to apply during development. `.env.local` is
 # gitignored, so you can freely customize it for your local setup.
 #
diff --git a/web/apps/photos/.env.localhost b/web/apps/photos/.env.localhost
index 136d0118b..9fbf1bcbf 100644
--- a/web/apps/photos/.env.localhost
+++ b/web/apps/photos/.env.localhost
@@ -1,8 +1,10 @@
 # Develop against a server running on localhost
 #
-# Copy this file to `.env`. Then if you run a local instance of the web client
-# with `yarn dev:photos`, it will connect to a locally running instance of the
-# server. Not everything will work, you might need to set other env vars (see
+# Copy this file to `.env.local`. Then if you run a local instance of the web
+# client with `yarn dev:photos`, it will connect to a locally running instance
+# of the server.
+#
+# Not everything will work, you might need to set other env vars (see
 # `.env.development`), but it should give you a usable baseline setup.
 #
 # Equivalent CLI command using environment variables would be