Comments on: Closing the documentation gap http://tech.turbu-rpg.com/104/closing-the-documentation-gap My thoughts on Delphi programming in general, and particularly on the technical aspects of developing the TURBU engine and editor. Sun, 29 Jan 2012 00:52:04 +0000 hourly 1 http://wordpress.org/?v=3.3.1 By: Jim McKeeth http://tech.turbu-rpg.com/104/closing-the-documentation-gap/comment-page-1#comment-222 Jim McKeeth Fri, 26 Mar 2010 08:06:42 +0000 http://tech.turbu-rpg.com/?p=104#comment-222 OK, I took your post and ran with it. http://www.delphi.org/2010/03/delphi-overflow-doc-wiki-initiative/ OK, I took your post and ran with it.

http://www.delphi.org/2010/03/delphi-overflow-doc-wiki-initiative/

]]> By: The Delphi Overflow Doc Wiki Initiative - The Podcast at Delphi.org http://tech.turbu-rpg.com/104/closing-the-documentation-gap/comment-page-1#comment-221 The Delphi Overflow Doc Wiki Initiative - The Podcast at Delphi.org Fri, 26 Mar 2010 07:55:15 +0000 http://tech.turbu-rpg.com/?p=104#comment-221 [...] was reading Mason’s post about Stack Overflow closing the Delphi documentation gap where he advocated Embarcadero setting up a new feature of the Delphi Doc Wiki so people could [...] [...] was reading Mason’s post about Stack Overflow closing the Delphi documentation gap where he advocated Embarcadero setting up a new feature of the Delphi Doc Wiki so people could [...]

]]> By: Yogi Yang http://tech.turbu-rpg.com/104/closing-the-documentation-gap/comment-page-1#comment-215 Yogi Yang Fri, 26 Mar 2010 04:49:09 +0000 http://tech.turbu-rpg.com/?p=104#comment-215 There is a facility in SO to make a question, answer, etc. as Wiki. Can't Embarcadero just borrow this contents from SO by paying a small fee? Such a feature should also be implemented into Embarcadero News Groups so any question/reply marked as Wiki should automatically get filed to wiki in some way. Just an idea! There is a facility in SO to make a question, answer, etc. as Wiki.

Can’t Embarcadero just borrow this contents from SO by paying a small fee?

Such a feature should also be implemented into Embarcadero News Groups so any question/reply marked as Wiki should automatically get filed to wiki in some way.

Just an idea!

]]> By: Jim McKeeth http://tech.turbu-rpg.com/104/closing-the-documentation-gap/comment-page-1#comment-213 Jim McKeeth Fri, 26 Mar 2010 02:12:07 +0000 http://tech.turbu-rpg.com/?p=104#comment-213 Maybe a better solution would be for Embarcadero to have a tech writer go through Stack Overflow's Delphi questions and where appropriate import the interesting bits into the Doc Wiki, then do a little cleaning and copy editing. More often then not a question answer pair like is found on Delphi would be out of place for the Doc Wiki. Maybe a better solution would be for Embarcadero to have a tech writer go through Stack Overflow’s Delphi questions and where appropriate import the interesting bits into the Doc Wiki, then do a little cleaning and copy editing. More often then not a question answer pair like is found on Delphi would be out of place for the Doc Wiki.

]]> By: Joar Bølstad http://tech.turbu-rpg.com/104/closing-the-documentation-gap/comment-page-1#comment-212 Joar Bølstad Wed, 24 Mar 2010 15:04:49 +0000 http://tech.turbu-rpg.com/?p=104#comment-212 Hi Mason, It was me who asked that question. I couldn't have agreed more, why Experts-Exchange failed to realize what they could've become is beyond me. And you're absolutely right regarding the docs as well: the documentation issues should have been solved directly in the wiki. Except for pricing, I believe the lack of documentation to be the single most important drawback of Delphi. I think inquiry driven documentation would be very interesting. Documentation based on questions would necessarily answer real world problems. To elaborate a little around your suggestion, consider the following: A user asks a question in some forum connected to the wiki. The question will enter a question pool. Volunteers can choose to answer questions from the pool, either by creating a new section in an existing article in the wiki (frequently) or create a new article if the question/answer calls for this (rarely). Finally, the question in the question pool will be automatically attached to the submitted content. Right? Hi Mason,

It was me who asked that question. I couldn’t have agreed more, why Experts-Exchange failed to realize what they could’ve become is beyond me. And you’re absolutely right regarding the docs as well: the documentation issues should have been solved directly in the wiki. Except for pricing, I believe the lack of documentation to be the single most important drawback of Delphi.

I think inquiry driven documentation would be very interesting. Documentation based on questions would necessarily answer real world problems. To elaborate a little around your suggestion, consider the following:

A user asks a question in some forum connected to the wiki. The question will enter a question pool. Volunteers can choose to answer questions from the pool, either by creating a new section in an existing article in the wiki (frequently) or create a new article if the question/answer calls for this (rarely). Finally, the question in the question pool will be automatically attached to the submitted content. Right?

]]>