diff --git a/docs/extensions/interacting-with-core b/docs/extensions/interacting-with-core
new file mode 100644
index 0000000000000000000000000000000000000000..1254068c1bb9cfd028a76e6f1ff717308947c962
--- /dev/null
+++ b/docs/extensions/interacting-with-core
@@ -0,0 +1,12 @@
+There are a number of ways in which extensions can interact with core. These are supported to greater or lesser degrees and only extensions that use fully supported methods are eligible for publication in the extensions directory.
+
+# Fully supported methods are:
+ - civicrm v3 api
+ - civicrm v4 api (when it is stable)
+ - hooks documented in this guide
+ - [Civi::cache](https://docs.civicrm.org/dev/en/latest/framework/cache/)
+ - Civi::$statics (page to be added)
+ - [Civi::settings](https://docs.civicrm.org/dev/en/latest/framework/setting/)
+ - internal symphony listeners  - 'civi.api.resolve', 'civi.api.prepare'
+ 
+