instructions in both files

Author: drammock

doc/sphinxext/related_software_nodeps.txt

@@ -1,4 +1,13 @@
-# deps with onerous requirements
+# This file is used to install extra packages into CircleCI when building our docs.
+# The purpose is to allow the packages in the "related software" list to be introspected
+# so we can get their URLs and Summary descriptions automatically.
+# **This file** is for packages with onerous dependencies (e.g., torch and tensorflow);
+# the sibling file `related_software.txt` is for ordinary packages.
+# Ideally each package should be tagged as one or more of the categories shown at the
+# top of `related_software.txt`; packages with no tags will be categorized as "Other".
+# Make sure to put categories at the END of the line, separated by commas if a package
+# fits in multiple categories.
+
 conpy  # requires future and subprocess32, which don't have wheels # categories: Connectivity and source analysis
 cross-domain-saliency-maps  # tensorflow # categories: Statistics and machine learning
 eelbrain #nowheels # categories: Statistics and machine learning, Visualization and real-time analysis