Collaborative Documentation Solutions - Revision history

Jfiat at 16:29, 22 July 2008

2008-07-22T16:29:56Z

2008-06-20T17:21:50Z

‎Temporary conclusion

2008-06-20T17:16:18Z

‎Comparison of potential solution

2008-06-20T17:10:26Z

‎Comparison of potential solution

2008-06-20T16:02:45Z

‎Temporary conclusion

2008-06-17T16:22:45Z

‎Key criteria

2008-06-17T16:19:27Z

‎Key criteria

2008-06-17T16:16:15Z

‎Key criteria

2008-06-17T16:15:19Z

‎Key criteria

2008-06-17T16:07:28Z

‎Key criteria

← Older revision		Revision as of 16:29, 22 July 2008
Line 1:		Line 1:
		+	[[Category:Documentation]]
	= Overview=		= Overview=
	*Find an alternative to our current xmldoc + doc_builder custom solution to edit, maintain and publish up to date documentation.		*Find an alternative to our current xmldoc + doc_builder custom solution to edit, maintain and publish up to date documentation.

@@ Line 186: / Line 186: @@
 ) Mediawiki + plugins .. need to find them. Of course we could go for other wiki, but I am worry to use too many wiki syntaxes
 ) Drupal + existing modules + our modules   (require developments...)
 = Comparison of potential solution =

@@ Line 188: / Line 188: @@
 = Comparison of potential solution =
@@ Line 232: / Line 233: @@
 |-
 | 3. Ease of editing
-| extension
+| plugin
-| WYSIWYGWYSIWYG
+| WYSIWYG++
 | WYSIWYG
 | WYSIWYG
-| WYSIWYG
+| WYSIWG
-−
 | WYSIWYG
@@ Line 276: / Line 277: @@
 still around in 10 years
 | Pretty popular thanks to Wikipedia
+| Large community.
-−
+Used for eiffelroom, origo, many major website.
 | Used by a few big Open Source Project.
@@ Line 360: / Line 365: @@
 However there are pleinty of extensions .. to tests.
 | ACL: ok
+| No section editing
+|
 | No media revision
+|
+| No section editing
 |-
@@ Line 378: / Line 392: @@
 |-
+|
+| Mediawiki
+| Drupal CMS
+| DaisyCMS
+| PmWiki
+| MoinMoin
+| Twiki
+| Confluence
 |}

@@ Line 188: / Line 188: @@
 = Comparison of potential solution =
 {| class="prettytable"
@@ Line 195: / Line 196: @@
 | DaisyCMS
 | PmWiki
-| DokuWiki
+| MoinMoin
+| Twiki
 |-
@@ Line 206: / Line 208: @@
 (xmldoc, or HTML)
+| Maybe using API/extensions
+| API, and maybe available modules.
+| API
+| API
+| API(python)
+| API (perl)
 |-
@@ Line 219: / Line 222: @@
 (from ec's output)
+| Same as previous, with revision I guess
+| Same as previous
+| “
+| “
+| “
+| “
 |-
 | 3. Ease of editing
+|
+| WYSIWYG
-−
-−
-−
-−
 |-
@@ Line 239: / Line 244: @@
 (offline)
+| Xml, Html, raw output per page
-−
-−
+extension for PDF
+| Html, raw output per page
-−
 |-
@@ Line 254: / Line 275: @@
 still around in 10 years
+|
+|
+|
+| Used by a few big Open Source Project.
-−
-−
 |-
 | 6. Free or not
+| free
+| free
+| free
+| free
+| free
+| free
 |-
@@ Line 278: / Line 304: @@
 are we locked in our choice?)
+|
+|
@@ Line 286: / Line 377: @@
 |-
+|
+|

← Older revision		Revision as of 16:02, 20 June 2008
Line 186:		Line 186:
	2) Mediawiki + plugins .. need to find them. Of course we could go for other wiki, but I am worry to use too many wiki syntaxes		2) Mediawiki + plugins .. need to find them. Of course we could go for other wiki, but I am worry to use too many wiki syntaxes
	3) Drupal + existing modules + our modules (require developments...)		3) Drupal + existing modules + our modules (require developments...)
		+
		+	= Comparison of potential solution =
		+
		+	{\| class="prettytable"
		+	\|
		+	\| Mediawiki
		+	\| Drupal CMS
		+	\| DaisyCMS
		+	\| PmWiki
		+	\| DokuWiki
		+	\|
		+
		+	\|-
		+	\| 1. Ease of import
		+
		+	from existing
		+
		+	documentation
		+
		+	(xmldoc, or HTML)
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\| 2. Ease of import
		+
		+	from EiffelStudio
		+
		+	(from ec's output)
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\| 3. Ease of editing
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\| 4. Ease of output generation
		+
		+	(offline)
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\| 5. Stability of the solution,
		+
		+	size of community,
		+
		+	user support,
		+
		+	still around in 10 years
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\| 6. Free or not
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\| 7. Ease of getting out
		+
		+	if better solution exists.
		+
		+	(i.e. how much
		+
		+	are we locked in our choice?)
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|-
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+	\|
		+
		+	\|}

@@ Line 169: / Line 169: @@
 *5. Stability of the solution, size of community, user support, how likely is it to be around 10 years from now...
 *6. Free or not
 Tools to be considered at the moment (short list): Drupal, Daisy CMS, MediaWiki.

@@ Line 159: / Line 159: @@
 = Key criteria =
-*1. Ease of import from existing HTML
+*1. Ease of import from existing documentation (xmldoc, or HTML)
-*2. Ease of import from EiffelStudio
+*2. Ease of import from EiffelStudio (from ec's generated content)
 *3. Ease of editing
-*4. Ease of output generation:
+*4. Ease of output generation (offline):
 **4.1 HTML
 **4.2 PDF