docs: comment improvements

app_data/vocabularies/affiliations.yaml

@@ -1,4 +1,4 @@
-# Full file: https://raw.githubusercontent.com/inveniosoftware/cookiecutter-invenio-rdm/master/%7B%7Bcookiecutter.project_shortname%7D%7D/app_data/vocabularies/affiliations_ror.yaml
+# Example aff file: https://github.com/inveniosoftware/invenio-rdm-records/blob/e3df51f5a9f25c20a4234e0d6e524c8d021d8fd2/invenio_rdm_records/fixtures/data/vocabularies/affiliations_ror.yaml
 # CCA affiliation org https://ror.org/01mmcf932
 - acronym: CCA
   id: 01mmcf932

invenio.cfg

@@ -195,9 +195,7 @@ SECURITY_RECOVERABLE = True  # local login: allow users to reset the password
 SECURITY_CHANGEABLE = True  # local login: allow users to change psw
 # Disable email confirmation
 SECURITY_CONFIRMABLE = False  # local login: users can confirm e-mail address
-SECURITY_LOGIN_WITHOUT_CONFIRMATION = (
-    True  # require users to confirm email before being able to login
-)
+SECURITY_LOGIN_WITHOUT_CONFIRMATION = True
 
 # Invenio-OAuthclient
 # -------------------

site/cca/customfields.py

@@ -8,10 +8,10 @@
 
 RDM_CUSTOM_FIELDS = [
     VocabularyCF(  # the type of custom field, VocabularyCF is a controlled vocabulary
-        name="cca:program",  # name of the field, namespaced by `cern`
+        name="cca:program",  # name of the field, namespaced by `cca`
         vocabulary_id="programs",  # controlled vocabulary id defined in the vocabularies.yaml file
         dump_options=True,  # True when the list of all possible values will be visible in the dropdown UI component, typically for small vocabularies
-        multiple=False, # if the field accepts a list of values (True) or single value (False)
+        multiple=False,  # if the field accepts a list of values (True) or single value (False)
     ),
 ]
 
@@ -30,11 +30,11 @@
                     description="Select one of CCA's academic programs",
                     autocompleteFrom="/api/vocabularies/programs",
                     autocompleteFromAcceptHeader="application/vnd.inveniordm.v1+json",
-                    multiple=False,   # True for selecting multiple values
+                    multiple=False,  # True for selecting multiple values
                     clearable=True,
-                )
+                ),
             ),
-        ]
+        ],
     }
 ]
 
@@ -51,7 +51,4 @@
     },
 }
 
-RDM_SEARCH = {
-    **RDM_SEARCH,
-    "facets": RDM_SEARCH["facets"] + ["program"]
-}
+RDM_SEARCH = {**RDM_SEARCH, "facets": RDM_SEARCH["facets"] + ["program"]}