[MonoDevelop] Documentation for MD 1.0

[R. Tyler Ballance]

On Nov 29, 2006, at 12:21 PM, Lluis Sanchez wrote:

> Hi!
>
> Several people has shown interest in helping in the 1.0 release,  
> and one
> of the areas that need work and requires little knowledge about the MD
> internals is documentation.
>
> So it would be good to define which documentation we would like to  
> have
> for MD 1.0, so people can start helping on that in a coordinated way.
>
> Which kind of documentation do we need?
> Which tutorials / walkthroughs do you think are interesting?
> Should we have an user guide? What would it include?
> Any volunteer for coordinating all this work?

I hate to jump in late in the game, but is supporting general  
variable code completion (i.e. I can start to type m_Con and a dialog  
with m_ConnectSocket and m_ConnectionList (or something) pops up?)  
part of that Text Editor clause?

When talking about NUnit integration, has anybody brought up NAnt as  
an option for builds instead of the "MonoDevelop build system?"


In terms of documentation, bringing Monodoc out into a more usable  
window with index searching, etc will do more than anything else  
IMHO ;) As for MD documentation,. I think a tutorial for creating a  
two project'd solution (possibly a web service and the app that uses  
the webservice) would be beneficial, as well as using Boo in a MD  
workflow (besides to zombie on my openSUSE 10.1 machine, I still  
haven't a bloody clue as to what boo is useful for ;))

I would also recommend finding somebody with a less monotone voice  
than RevFry, who's knowledgeable to create screencasts (which have  
helped Textmate's popularity IMMENSELY i think) to walk users through  
some of the more simple and then increasingly complex uses for  
MonoDevelop. I'd be willing to give this a shot, but I am a terrible  
MD user, I really just use it for an editor and then NAnt (I need a  
cross-platform build system) for most projects.


Other than that, Lluis, the roadmap looks nice, looking forward to it :)

Cheers
R. Tyler Ballance: Custom Mac and Linux Development at bleep. consulting
contact: tyler at bleepconsulting.com | jabber: tyler at jabber.geekisp.com


-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.ximian.com/pipermail/monodevelop-list/attachments/20061129/59042e5f/attachment.html