Current state

In 2.14 version documentation we have 2 places which define how to create custom policies:

Method 1 (new one)

• In Installing APIcast > 3.5.1.4. Injecting custom policies with the APIcast operator
• In Installing 3scale API Management on OpenShift > 
  2.5.3. Injecting custom policies with the 3scale API Management operator

Method 2 (old one)

• In Administering the API Gateway > I. The API Gateway > 4.3. Custom 3scale APIcast policies

Issues

• Technically and from support point of view, the Method 2 is still valid. However it's not up to date according to issues THREESCALE-6188, THREESCALE-6187 & THREESCALE-6182.

• Customers are not aware that a different approach is documented (Method 1) or vice versa.

Desired state:

• Option 1: Remove Method 2 from the documentation since Method 1 is easier to implement and troubleshoot. However we need to make sure that ALL use cases can be achieved using Method 1.
• Option 2: Update the Method 2 when APIcast is deployed with the 3scale and APIcast operators and create a link that references the Method 1 in the documentation. Also create a link in the documentation of Method 1 that references Method 2.