refactor docs

Author: toumix

.gitignore

@@ -13,7 +13,7 @@
 *.pyc
 *.nav
 docs/_build/*
-docs/api/*
+docs/_api/*
 */__pycache__/*
 *.egg-info
 build/*

discopy.bib

@@ -0,0 +1,21 @@
+@article{DelpeuchVicary22,
+  title = {Normalization for Planar String Diagrams and a Quadratic Equivalence Algorithm},
+  author = {Delpeuch, Antonin and Vicary, Jamie},
+  date = {2022},
+  journaltitle = {Logical Methods in Computer Science},
+  shortjournal = {Log. Methods Comput. Sci.},
+  volume = {18},
+  number = {1},
+  doi = {10.46298/lmcs-18(1:10)2022}
+}
+
+@article{Selinger10,
+  title = {A {{Survey}} of {{Graphical Languages}} for {{Monoidal Categories}}},
+  author = {Selinger, P.},
+  date = {2010},
+  journaltitle = {New Structures for Physics},
+  pages = {289--355},
+  doi = {10.1007/978-3-642-12821-9_4},
+  keywords = {18D10,Mathematics - Category Theory},
+  file = {/Users/alexis.toumi/WORK/Zotero/storage/3HSB2T6D/Selinger - 2010 - A survey of graphical languages for monoidal categ.pdf;/Users/alexis.toumi/WORK/Zotero/storage/VGWGBWBQ/0908.html}
+}

discopy/__init__.py

@@ -1,9 +1,6 @@
 # -*- coding: utf-8 -*-
 
-"""
-The library is organised in five groups of modules:
-syntax, semantics, quantum, grammar and other.
-"""
+""" DisCoPy: the Python toolkit for computing with string diagrams. """
 
 from discopy import (
     cat,

discopy/monoidal.py

@@ -721,7 +721,7 @@ def interchange(self, i: int, j: int, left=False) -> Diagram:
     def normalize(self, left=False) -> Iterator[Diagram]:
         """
         Implements normalisation of boundary-connected diagrams,
-        see arXiv:1804.07832.
+        see :cite:t:`DelpeuchVicary22`.
 
         Parameters:
             left : Passed to :meth:`Diagram.interchange`.

discopy/quantum/__init__.py

@@ -4,7 +4,8 @@
 DisCoPy quantum modules: channel, circuit, gates, tk and zx.
 """
 
-from discopy.quantum import circuit, gates, channel, ansatze, optics, zx
+from discopy.quantum import (
+    circuit, gates, channel, ansatze, zx)
 
 from discopy.quantum.channel import C, Q, CQ, Channel
 

discopy/quantum/gates.py

@@ -11,9 +11,8 @@
     :nosignatures:
     :toctree:
 
-    AntiConjugate
-    Anti2QubitConjugate
     SelfConjugate
+    AntiConjugate
     Discard
     MixedState
     Measure