Docs: add code-comments to clarify bad-level include & developer only UI

scripts/addons_core/bl_pkg/bl_extension_ui.py

@@ -300,6 +300,11 @@ def addon_draw_item_expanded(
         row.label(text=mod.__file__, translate=False)
 
         # Add a button to quickly open the add-on's folder for accessing its files and assets.
+        #
+        # Only show this with a developer UI since extensions should be
+        # usable without direct file-system access / manipulation.
+        # If non-technical users need this for some task then we could consider alternative solutions,
+        # see: #128474 discussion for details.
         if show_developer_ui:
             import os
             row.operator("wm.path_open", text="", icon='FILE_FOLDER').filepath = os.path.dirname(mod.__file__)

source/blender/blenkernel/CMakeLists.txt

@@ -837,6 +837,8 @@ if(WITH_GTESTS)
     intern/volume_test.cc
   )
   set(TEST_INC
+    # WARNING: this is a bad-level include which is only acceptable for tests
+    # and even then it would be good if the dependency could be removed.
     ../editors/include
   )
   set(TEST_LIB