Yes, WikiML is a fundamental thing to have. I've seen many people affraid of adopting this or that wiki, just because one has a feature that the other doesn't and the their languages are so different... The most common result is simply 'no wiki' adoption. JB 2005-10-05 19:30:39.448 2005-10-05 19:30:37.6 1 "Wiki-based Software Documentation" contributions Here you can add your contribution to the [Wiki-based Software Documentation] workshop. 1.1 {anchor: wikiml} WikiML: a normalized internal markup language [Ademar Aguiar] It is very important to develop a common internal markup language, one we can use internally in a wiki implementation, which could facilitate contents interchange and interoperability between wikis and other software engineering tools. The user's markup language can be translated to this internal format, something like a Wiki Markup Language, in XML, maybe. 1.1 {anchor: wiki2x} WikiToX: make a 'book' out of a wiki [Jos? Bonnet] There's one single and final step needed for wikis to go mainstream within a not so small software development shop: take any node, and linearize its content from there, exporting it to a well known format (HTML, PDF, Post-Script, ...). So, the whole User Manual could be generated like this. Or the Administration Manual. Or the Requirements Report... With such a feature (plus WikiML, so that you could migrate between wikis) you'd still be able to gather your 'developers' around the wiki, and even generate an old fashioned (or not...) document with its content. 1.1 {anchor: sota} Collect bibliography [Gabriel David] As one of the goals of the workshop is to prepare the plan of a survey article, I suggest as one pre-workshop task to collect here relevant bibliography on our subject, be it a theoretical paper, an experiment report, a wish list, or ... This way it would be easier to organize the actual practice and state of the art review part of the workshop. 1.1 {anchor: wikisync} WikiSync: yes, it is a connected world, but not always... [Jos? Bonnet] What if one could go on editing wiki pages while flying an air-line with no affordable connection? What if those pages could be transparently uploaded to the main wiki just when the traveller got to a nice wi-fi hot spot? Conflicts might arise, of course, but we have the technology to 'solve' them (take CVS...)! 1.1 ...your contribution title... ...your name... ...description if your contribution ... ---- Hey guys, I notice there's a lot of overlap between this workshop and the [Interwiki workshop]. Specifically, WikiML and WikiSync are both exactly the sort of things we'll be talking about there. - [Bayle Shanks] ---- Hi Bayle! You are right. There is a lot of potential for overlaping between the workshops, and the WikiML is one example of it. Anyway, in this workshop the focus is on using wikis specifically to ~~document software~~, so I think there is space for both workshops. We need to merge results at the end! - [Ademar Aguiar] Ademar Aguiar Ademar Aguiar 2005-10-06 23:13:20.264 2005-10-05 12:03:10.48