[Mono-docs-list] Wiki Markup for ECMA documents.

[Atsushi Eno]

Hola!

>> Am not sure what kind of transformations are actually wanted, so
>> am putting as its initial draft. The output is like:
>> http://monkey.workarea.jp/trans/mono/index.php/TestMonodocToMediaWiki
> I think the idea (at least what I thought it was) was to transform not
> the entire XML docs but what goes inside every section the user can
> edit (say summary, remarks, ...). So, the XSLT should transform the
> "example", "list", "table", .... tags (the buttons that you can find
> in the monodoc tool when you hit the Edit link) into something more
> Wiki-like. And the other way around.

Yup, I agree with you. In fact, my stylesheet is designed to accept
"summary" and "remarks" as the document element (as well as other
elements, so that I can test the stylesheet itself) :-)

Actually, I've noticed that editing the entire document would also
be easy when we have to copy and paste the contents on things like
a couple of overloads. I mostly use text editor to write docs because
of this reason; writing raw XML is not so painful *for me* as
compared to editing content on monodoc, because browser.exe anyways
wants me to write raw <see>/<seealso> markups.

>> (I also think that some kind of editor UI which is well-tailored for
>> monodoc would be better.)
> What are you exactly thinking (there is already the monodoc tool UI
> for editing).

Well, I thought that the original idea is to receive more
contributions *via the web* (MediaWiki). Thus, what I've thought was,
kind of web forms (either simple HTML + submission form, or kind of
web applications).

If it is just a matter of input syntax, no further thought is needed ;-)

Atsushi Eno