docs: comments in main config file

invenio.cfg

@@ -124,10 +124,15 @@ INSTANCE_THEME_FILE = "./less/theme.less"
 COMMUNITIES_ADMINISTRATION_DISABLED = False
 # New as of v12.0.0, default is "redis://localhost:6379/4"
 COMMUNITIES_IDENTITIES_CACHE_REDIS_URL = "redis://localhost:6379/1"
-# can add custom fields to communities, too
+# Can add custom fields to communities, too
 # https://inveniordm.docs.cern.ch/customize/custom_fields/communities/
+# Require every record hav a community?
+# https://discord.com/channels/692989811736182844/704625518552547329/1301855502397083699
+# RDM_COMMUNITY_REQUIRED_TO_PUBLISH = True
 
 # Only allow admins to create communities
+# TODO eventually there'll be a Community Creator role we can give only to admins
+# TODO https://github.com/inveniosoftware/rfcs/issues/90
 # https://discord.com/channels/692989811736182844/704625518552547329/1296091404409372763
 from invenio_administration.generators import Administration
 from invenio_communities.permissions import CommunityPermissionPolicy
@@ -152,12 +157,13 @@ COMMUNITIES_PERMISSION_POLICY = CustomCommunityPermissionPolicy
 
 # We don't have ORCID, etc. for our users, let URLs be identifiers
 # https://discord.com/channels/692989811736182844/1212764629604769792
-# ! https://github.com/cca/cca_invenio/issues/28
+# https://github.com/cca/cca_invenio/issues/28
 from invenio_rdm_records.config import RDM_RECORDS_IDENTIFIERS_SCHEMES
 from invenio_rdm_records.config import RDM_RECORDS_PERSONORG_SCHEMES
 from invenio_vocabularies.config import VOCABULARIES_NAMES_SCHEMES
 
-# We capitalize URL b/c name of scheme, _not_ its label, appears on deposit form once
+# Cannot capitalize URL even though it's used as a label in the Creator UI
+# schemes are expected to be lowercase (see keys of the imported dicts above)
 RDM_RECORDS_PERSONORG_SCHEMES["url"] = RDM_RECORDS_IDENTIFIERS_SCHEMES["url"]
 VOCABULARIES_NAMES_SCHEMES["url"] = RDM_RECORDS_IDENTIFIERS_SCHEMES["url"]