Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Is It Time To Rethink The Delphi Help File System?

The majority of components available for Delphi do not have HTML Help files for Delphi 2009. Many components including some very popular commercial components only have HLP and CHM help files.

Many of the third-party components are no longer being actively developed but are used by many developers. As a result there is no IDE help for these components.

There were very few complaints about the old CHM help files but today there are a large number of complaints about the help file system. Maybe it is time for Codegear to rethink the type of help file system used.

One of the complaints that I have about it is even when you install components that provide HTML help files the Contents Tab becomes corrupted where by previously installed component contents are removed.

Are there possible alternatives for Codegear to consider?

like image 630
Bill Miller Avatar asked Apr 21 '09 15:04

Bill Miller


3 Answers

I have the same feeling. The old help system helps me more quickly to find an answer.

like image 185
stanleyxu2005 Avatar answered Oct 19 '22 16:10

stanleyxu2005


One idea is to maybe to model it after the Delphi Wiki at: http://delphi.wikia.com/wiki/Delphi_Wiki

The wiki actually isn't set up that bad, especially with the VCL link in the left frame.

It's fairly pleasant to look at, has a decent search, includes issues, examples, cross references, and what I like the most: user comments and tips.

Actually regarding the user comments and tips, the thing I like most about the PHP documentation at www.php.net/docs.php (which I think is the best programming documentation I've seen) is the user comments and tips.

If they can integrate the great layout that you'll find at Delphi Basics into it, and allow 3rd party components to add their help files into it, then they'll have a complete reference. (But the 3rd parties will obviously have to restructure their help files to the new format - whatever it ends up as).

The wiki also has sections for Tutorials, Tips and Tricks, References and Popular Articles. And I think it could also become the all-encompassing code-repository we all would like.

An option to download the help wiki should be allowed so it can be accessed offline.

And they'll have to figure out how to get the F1 key to work to properly search the wiki/help file, whether online or offline, and give the most relevant results.

The trouble with the Wiki now is that it is not complete, and the full set of Delphi help files need to be incorporated into it.

This might be a pipedream, but something like this would be my ideal.

like image 38
lkessler Avatar answered Oct 19 '22 17:10

lkessler


This is a pet hate of mine. The Delphi Help has just got worse, although with a recent slight improvement. I honestly believe that this is one of the things holding back its adoption.

like image 43
Brian Frost Avatar answered Oct 19 '22 16:10

Brian Frost