diff --git a/doc/manual/core_device.rst b/doc/manual/core_device.rst
index 5d3800e09..6c5776194 100644
--- a/doc/manual/core_device.rst
+++ b/doc/manual/core_device.rst
@@ -29,6 +29,13 @@ KC705
 
 The main target board for the ARTIQ core device is the KC705 development board from Xilinx. It supports the NIST QC1 hardware via an adapter, and the NIST CLOCK and QC2 hardware (FMC).
 
+Common problems
++++++++++++++++
+
+* The SW13 switches on the board need to be set to 00001.
+* When connected, QC1 and CLOCK adapters break the JTAG chain due to TDI not being connect to TDO on the FMC mezzanine.
+* On some boards, the JTAG USB connector is not correctly soldered.
+
 NIST QC1
 ++++++++
 
diff --git a/doc/manual/installing.rst b/doc/manual/installing.rst
index c282a46ea..f2e0d90ea 100644
--- a/doc/manual/installing.rst
+++ b/doc/manual/installing.rst
@@ -135,6 +135,8 @@ Then, you can flash the board:
 
     $ artiq_flash -t kc705 -m [nist_qc1/nist_clock/nist_qc2]
 
+  The SW13 switches also need to be set to 00001.
+
 For the KC705, the next step is to flash the MAC and IP addresses to the board. See :ref:`those instructions <flash-mac-ip-addr>`.
 
 .. _install-from-sources: