doc

Provides a consistent way to create documentation for prosperon elements. Objects are documented by adding docstrings directly to object-like things (functions, objects, ...), or to an object's own "doc object".

Docstrings are set to the symbol prosperon.DOC

// Suppose we have a module that returns a function
function greet(name) { console.log("Hello, " + name) }

// We can attach a docstring
greet.doc = `
Greets the user by name.
`

// A single function is a valid return!
return greet

// Another way is to add a docstring object to an object
var greet = {
hello() { console.log('hello!') }
}

greet[prosperon.DOC] = {}
greet[prosperon.DOC][prosperon.DOC] = 'An object full of different greeter functions'
greet[prosperon.DOC].hello = 'A greeter that says, "hello!"'

name: The name of the person to greet.

writeDocFile(obj, title) _function

Return a markdown string for a given obj, with an optional title.