fix: support parsing summary docstring that is not well formed (#200)

* fix: support parsing summary docstring even if it not well formed

* test: update unit test

* chore: remove unneeded TODO comment

Co-authored-by: Anthonios Partheniou <partheniou@google.com>

Author: dandhlee

docfx_yaml/extension.py

@@ -469,9 +469,10 @@ def _parse_docstring_summary(summary):
                 continue
 
         # Parse keywords if found.
-        if part.startswith(".."):
+        # lstrip is added to parse code blocks that are not formatted well.
+        if part.lstrip('\n').startswith('..'):
             try:
-                keyword = extract_keyword(part)
+                keyword = extract_keyword(part.lstrip('\n'))
             except ValueError:
                 raise ValueError(f"Please check the docstring: \n{summary}")
             # Works for both code-block and code

tests/test_unit.py

@@ -736,6 +736,7 @@ def test_extract_header_from_markdown_bad_headers(self):
 
         self.assertEqual(header_line_want, header_line_got)
 
+
     def test_parse_docstring_summary(self):
         # Check that the summary gets parsed correctly.
         attributes_want = []
@@ -794,7 +795,7 @@ def get_client_cert():
 You can also pass a mapping object.
 
 
-.. code-block:: ruby
+\n.. code-block:: ruby
 
 \n    from google.cloud.vision_v1 import ImageAnnotatorClient
 \n    client = ImageAnnotatorClient(