Add comment explaining how to update reqs file (#202)

Also included is an accidental edit to the docsite instructions that
made sense.

b/322392437

cobalt/site/README.md

@@ -14,7 +14,7 @@
 3.  Run it to regenerate the site.
 
     ```shell
-    $ docker run -it --mount type=bind,source=$(pwd),target=/code docsite
+    $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code docsite
     ```
 
 4.  (Optional) To preview the changes you must commit the generated files and

docker/linux/linux-x64x11/requirements.in

@@ -1,2 +1,8 @@
+# IMPORTANT: Remember to also update requirements.txt when updating this file:
+# $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code -w /code python:3.8 /bin/bash
+# In the container:
+# $ pip3 install pip-tools
+# $ pip-compile --allow-unsafe --generate-hashes path/to/requirements.in
+
 selenium==3.141.0
 Brotli==1.0.9

docker/linux/unittest/requirements.in

@@ -1,3 +1,9 @@
+# IMPORTANT: Remember to also update requirements.txt when updating this file:
+# $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code -w /code python:3.8 /bin/bash
+# In the container:
+# $ pip3 install pip-tools
+# $ pip-compile --allow-unsafe --generate-hashes path/to/requirements.in
+
 selenium==3.141.0
 Brotli==1.0.9
 junitparser==2.8.0

docker/precommit_hooks/requirements.in

@@ -1,3 +1,9 @@
+# IMPORTANT: Remember to also update requirements.txt when updating this file:
+# $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code -w /code python:3.8 /bin/bash
+# In the container:
+# $ pip3 install pip-tools
+# $ pip-compile --allow-unsafe --generate-hashes path/to/requirements.in
+
 pre-commit<3
 cpplint<2
 yapf<1

docker/pytest/requirements.in

@@ -1,3 +1,9 @@
+# IMPORTANT: Remember to also update requirements.txt when updating this file:
+# $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code -w /code python:3.8 /bin/bash
+# In the container:
+# $ pip3 install pip-tools
+# $ pip-compile --allow-unsafe --generate-hashes path/to/requirements.in
+
 pytest>=7.2.0
 coverage<7
 requests>=2.31.0

docker/windows/base/build/requirements.in

@@ -1 +1,7 @@
+# IMPORTANT: Remember to also update requirements.txt when updating this file:
+# $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code -w /code python:3.8 /bin/bash
+# In the container:
+# $ pip3 install pip-tools
+# $ pip-compile --allow-unsafe --generate-hashes path/to/requirements.in
+
 six

precommit_hooks/requirements.in

@@ -1,3 +1,9 @@
+# IMPORTANT: Remember to also update requirements.txt when updating this file:
+# $ docker run -it --mount type=bind,source=${COBALT_SRC},target=/code -w /code python:3.8 /bin/bash
+# In the container:
+# $ pip3 install pip-tools
+# $ pip-compile --allow-unsafe --generate-hashes path/to/requirements.in
+
 pre-commit<3
 cpplint<2
 yapf<1