[Gtk-sharp-list] Full documentation by 1.0
Miguel de Icaza
miguel@ximian.com
Wed, 23 Jun 2004 17:20:21 -0400
Hello Brian,
Thanks for the feedback. I do not know that there is much that can
be done to monodoc in the short term though, with the freeze coming and
everything.
Here are some comments.
> I think part of the problem is that monodoc's editing function can be
> frustrating to use. I've experienced the following problems with it:
> * Ctrl-C doesn't work in edit mode. Select/Middle=click pasting doesn't
> work too well either.
I have this on the TODO list already.
> * If you close before submitting your contributions, it won't recognize
> the changes (or something, that's as far as I can tell)
Mhm, it keeps them on the disk, if you upload, it will still send them.
> * No spell checker.
Agreed, but not something we can fix right away.
> * The buttons aren't really clear and not HIGified.
A patch was commited, but it broke hotkeys, so I have taken it out for
now.
> * No explanation that you need to use different letters to reference
> members, fields, classes, et al.
www.go-mono.com/documentation.html has some information on this.
> * No documentation/guidelines as to how documentation should look,
> sentence structure, brevity, descriptions, et al.
Agreed. We need to cook this up, volunteers?
> * No undo/redo.
Yup.
> * Crashed after I submitted contributions the first time. (Is this
> fixed?)
It works here, can you try again?
Miguel