[Docs] Add calibration FAQ (#4442)

This adds FAQ / more information about calibration from @mrwojtek and others. cc @karlunho
quantumlib · Sep 14, 2021 · 91bfb5c · 91bfb5c
1 parent b3fa1bf
commit 91bfb5c
Show file tree

Hide file tree

Showing 6 changed files with 321 additions and 1 deletion.
diff --git a/docs/_book.yaml b/docs/_book.yaml
@@ -107,6 +107,8 @@ upper_tabs:
         path: /cirq/google/specification
       - title: "Calibration metrics"
         path: /cirq/google/calibration
+      - title: "Calibration FAQ"
+        path: /cirq/google/calibration_faq
       - title: "Best practices"
         path: /cirq/google/best_practices
 

diff --git a/docs/google/calibration_faq.md b/docs/google/calibration_faq.md
diff --git a/docs/google/linear_chain_with_calibration_example_results.png b/docs/google/linear_chain_with_calibration_example_results.png
diff --git a/docs/google/loschmidt_echo_with_calibration_example_results.png b/docs/google/loschmidt_echo_with_calibration_example_results.png
diff --git a/docs/google/merge_subsets.png b/docs/google/merge_subsets.png
diff --git a/docs/tutorials/google/calibration_api.ipynb b/docs/tutorials/google/calibration_api.ipynb
@@ -541,7 +541,9 @@
     "Try running Floquet and/or XEB calibration on your circuit(s). See the following tutorials for detailed examples and benchmarks.\n",
     "\n",
     "- [Floquet calibration: Example and benchmark](./floquet_calibration_example.ipynb)\n",
-    "- [XEB calibration: Example and benchmark](./xeb_calibration_example.ipynb)"
+    "- [XEB calibration: Example and benchmark](./xeb_calibration_example.ipynb)\n",
+    "\n",
+    "See also the [Calibration FAQ](../../google/calibration_faq.md) for additional information on calibration."
    ]
   }
  ],