Better formatting of docstring

[yzhang-gh]

'Translate' reStructuredText into Markdown. Fix #821.

Screenshots

[yzhang-gh]

I think it's just a workaround because at present the APIs are limited (rendering the text as Markdown).

• Setext headings -> ATX headings (## Section Title)
• Directives: .. directive:: -> **directive**
• Field lists: :field: -> **field**
• varname : description -> `varname` description
• Doctest blocks: begin with >>> and end with blank line -> Markdown code blocks
• Literal blocks: begin with :: (literal blocks are indented or quoted; for simplicity, we end literal blocks with blank line)
• Remove indention in Field lists and Literal blocks
• Grid tables

[1st]

Looks good. But in my opinion, it will be fine to make headers much smaller, because white color already telling us tgat this is a header (like Examples, Returns, References)

[DonJayamanne]

@neilsustc Thanks for your work on this. Let me know when you are ready for me to merge something.

[DonJayamanne]

How about you get things working to a certain stage and we merge it.
I.e. merge incrementally...

[yzhang-gh]

I think the docs will look good in most cases now, especially for numpy and sklearn.

But there are some conflicts and failed tests, @DonJayamanne can you help fix them?

---

@1st I have set the headings to level 2 so they would become a bit smaller now.

[yzhang-gh]

@DonJayamanne All done!

[DonJayamanne]

Brilliant risk work mate, will check this out tonight and release something soon.

[DonJayamanne]

@neilsustc , there are some conflicts in jediHelper.ts, please could you resolve them.

[yzhang-gh]

👌

[1st]

Will be happy to test this new thing