Hey guys,

   I just wanted to record the idea here, because I remember it was mentioned some time ago, and we discussed this today.  We have been thinking about making Monodoc an editor for documentation;  Unlike the previous approach, we are thinking about a very conservative effort.

    The idea is that when a special editing mode is turned on, different elements in the ECMA documentation (those that we are supposed to edit) would show up next to them as a link, like this:

Sample


Summary:
       This class does interesting things [Edit this]

Remarks:
   
Avoid using this class from a thread, or operating it while drunk, it might have
    adverse effects on the system's health. [Edit this]
  





    There is some code on CVS that turns the link on for summaries of classes I believe (export the MONODOC_EDITING environment variable to see it).

    To make this happen we would need:

  • To add [Edit this] links to the mono-ecma.xsl file in the proper places.
  • To "expand" the anchor target to include the element to be edited;  For example

    Those of us involved in Monodoc are very busy, and we do not have a lot of spare time to take this project to the end, but there are various concrete tasks that could be done to advance this project.


--
Miguel de Icaza <[EMAIL PROTECTED]>

Reply via email to