From 04e7857519989c4ab2ef5d66f84f3c6bf2a98991 Mon Sep 17 00:00:00 2001
From: Pieter Lange <pieterlange@users.noreply.github.com>
Date: Mon, 2 Jul 2018 17:14:07 +0200
Subject: [PATCH] Add doc on secret references for cluster issuers

---
 docs/reference/clusterissuers.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/reference/clusterissuers.rst b/docs/reference/clusterissuers.rst
index 686e5867d..2fb20aec1 100644
--- a/docs/reference/clusterissuers.rst
+++ b/docs/reference/clusterissuers.rst
@@ -44,5 +44,7 @@ the ``spec.issuerRef.kind`` field to ClusterIssuer:
        kind: ClusterIssuer
      ...
 
+When referencing a ``Secret`` resource in ``ClusterIssuer`` resources (eg ``apiKeySecretRef``) the ``Secret`` needs to be in the same namespace as the ``cert-manager`` controller pod. You can optionally override this by using the ``--cluster-resource-namespace`` argument to the controller.
+
 For more information on configuring Issuer resources, see the :doc:`Issuers </reference/issuers>`
 reference documentation.