Weird documentation rendering after updating to tfv2

[brollb]

It looks like some of the formatting of the docstrings in tf v2 don't quite match the formats used in keras which results in ugly rendering:

[umesh-timalsina]

Does this take care of the examples field in docstring Example fields like these?

deepforge-keras/src/visualizers/widgets/KerasArchEditor/Buttons.js

Lines 181 to 189 in 544e354

	ShowHelpDocs.convertDocsToHtml = function(docs) {
	// First preprocess the docstring to (nice) markdown
	docs = docs
	.replace(/^\s*/mg, '') // default indentation creates code blocks
	// Convert the arguments to a list
	.replace(/^([a-zA-Z_]+):/mg, (match, argName) => `- ${argName}:`);
	return mdConverter.makeHtml(docs);
	};

[brollb]

ah, good catch. I don't think so. It might be good to try to detect the headers. They seem to follow a standard convention of a line with just the header and a colon...

I am not sold that this is the best approach but parsing docstrings is harry business...

[umesh-timalsina]

For now, we decided to remove examples from the docstring from the rendered markdown. Later on, we can investigate more on how to render the example visually rather than as python code that the user needs to convert to a layer again.

[brollb]

There is also an issue with the graph nn layers (from spektral) as they could really use mathjax or something similar to render the equations: