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.