From cbc4651cb05ea84090eabbd7b465b9e9362b5af0 Mon Sep 17 00:00:00 2001
From: Eileen McNaughton <eileen@mcnaughty.com>
Date: Thu, 14 Dec 2017 10:42:21 +1300
Subject: [PATCH] Create interacting-with-core

Per discussion in documentation channel I think we need to document what methods are considered supported / expected to be stable. The last 4 items in this list have not been previously documented as a supported way to interact with CiviCRM so may be subject to discussion
---
 docs/extensions/interacting-with-core | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 docs/extensions/interacting-with-core

diff --git a/docs/extensions/interacting-with-core b/docs/extensions/interacting-with-core
new file mode 100644
index 00000000..1254068c
--- /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'
+ 
+ 
-- 
GitLab