This page is likely outdated. Visit the new documentation for updated content.

Document APIs using XML docs

Status Owner Importance Complexity MD Version
In Progress everyone Normal Low

The public MD APIs should be documented with XML docs so that developers working on MD or writing addins get tooltips etc. At this point these are much easier to maintain than MonoDoc sources.

Integrated help for MD

Status Owner Importance Complexity MD Version
Pending Low Medium

It would be useful for MonoDoc to have integrated help for common topics. This could perhaps be maintained via DocBook and exported to each platform’s natuive help system.

Recording and annotation of MD session for interactive walkthroughs/tours

Status Owner Importance Complexity MD Version
Pending Low Medium

For tutorials, walkthroughs and tours, it would be useful to be able to record actions and inputs in a MD session and annotate it with tooltips containing explanations. Then users could step through these recordings at their own pace directly in the IDE.

Rather than a full general purpose app recording tool, we would want something deeply integrated into MD taking advantage of the MD APIs.

In recording mode, there would be a pad with a list of walkthrough steps. The use could add, remove and reorder steps. For each step, they could edit the title and description, and enter a recording mode, which would record commands, pad/view focus changes, and text inserted into the text editor. Support for recording additional kinds of actions could be added later.

In playback mode, the user could search all the walkthough from the walkthrough pad, and on selecting one, they would be shown a list of steps. Clicking on a step would make MD draw a highlight & tooltip on the commands or views/pads described in the step. Clicking on a recorded text snippet would insert it into the editor.

The infrastructure would also provide a good basis for a macro system.

Local MonoDoc server

Status Owner Importance Complexity MD Version
Assigned mhutch Normal 1w 2.8

A MonoDoc web server built into MD so that we have docs browser even on platforms that don’t have a MonoDoc GUI. VS 2010 actually removed their dedicated browser in favour of somthing like this.

Should be quite simple because we can re-use xsp and the existing docs server.