Fix from_diagram docstring on GridQubit.

cirq-core/cirq/devices/grid_qubit.py

@@ -205,19 +205,25 @@ def rect(
 
     @staticmethod
     def from_diagram(diagram: str, dimension: int) -> List['GridQid']:
-        r"""Parse ASCII art device layout into info about qids and
-        connectivity. As an example, the below diagram will create a list of
-        GridQid in a pyramid structure.
+        r"""Parse ASCII art device layout into a device.
+
+        As an example, the below diagram will create a list of GridQid in a
+        pyramid structure.
+
+
+        ```
         ---A---
         --AAA--
         -AAAAA-
         AAAAAAA
+        ```
 
         You can use any character other than a hyphen to mark a qid. As an
         example, the qids for the Bristlecone device could be represented by
         the below diagram. This produces a diamond-shaped grid of qids, and
         qids with the same letter correspond to the same readout line.
 
+        ```
         .....AB.....
         ....ABCD....
         ...ABCDEF...
@@ -229,20 +235,22 @@ def from_diagram(diagram: str, dimension: int) -> List['GridQid']:
         ...GHIJKL...
         ....IJKL....
         .....KL.....
+        ```
 
         Args:
             diagram: String representing the qid layout. Each line represents
                 a row. Alphanumeric characters are assigned as qid.
-                Dots ('.'), dashes ('-'), and spaces (' ') are treated as
+                Dots ('.'), dashes ('-'), and spaces are treated as
                 empty locations in the grid. If diagram has characters other
                 than alphanumerics, spacers, and newlines ('\n'), an error will
                 be thrown. The top-left corner of the diagram will be have
-                coordinate (0,0).
-            dimension: The dimension of the qubits in the `GridQid`s used
+                coordinate (0, 0).
+
+            dimension: The dimension of the qubits in the `cirq.GridQid`s used
                 in this construction.
 
         Returns:
-            A list of GridQid corresponding to qids in the provided diagram
+            A list of `cirq.GridQid`s corresponding to qids in the provided diagram
 
         Raises:
             ValueError: If the input string contains an invalid character.