Convert notes about some OpenDocument tests to comments

Author: detrout

pandas/tests/io/test_excel.py

@@ -2604,26 +2604,20 @@ def test_read_types(self):
         tm.assert_equal(sheet, expected)
 
     def test_read_invalid_types_raises(self):
-        """Make sure we throw an exception when encountering a new value-type
-
-        I had to manually create an invalid ods file by directly
-        editing the extracted xml. So it probably won't open in
-        LibreOffice correctly.
-        """
+        # the invalid_value_type.ods required manually editing
+        # of the included content.xml file
         with pytest.raises(ValueError,
                            match="Unrecognized type awesome_new_type"):
             self.get_exceldf(
                 'invalid_value_type', '.ods', header=None, engine='odf')
 
     def test_read_lower_diagonal(self):
-        """TextParser failed when given an irregular list of lists
+        # Make sure we can parse:
+        # 1
+        # 2 3
+        # 4 5 6
+        # 7 8 9 10
 
-        Make sure we can parse:
-        1
-        2 3
-        4 5 6
-        7 8 9 10
-        """
         sheet = self.get_exceldf(
             'lowerdiagonal', '.ods', 'Sheet1',
             index_col=None, header=None, engine='odf')
@@ -2651,10 +2645,9 @@ def test_read_headers(self):
                 assert pd.isnull(value)
 
     def test_read_writer_table(self):
-        """ODF reuses the same table tags in Writer and Presentation files
+        # Also test reading tables from an text OpenDocument file
+        # (.odt)
 
-        Test reading a table out of a text document
-        """
         table = self.get_exceldf(
             'writertable', '.odt', 'Table1', index_col=0, engine='odf')
 
@@ -2682,8 +2675,6 @@ def test_blank_row_repeat(self):
         assert not pd.isnull(table['value'][11])
 
     def test_runlengthencoding(self):
-        """Calc will use repeat when adjacent columns have the same value.
-        """
         sheet = self.get_exceldf(
             'runlengthencoding', '.ods', 'Sheet1', header=None, engine='odf')
         assert sheet.shape == (5, 3)