Home » Developing U++ » U++ Developers corner » Documentation and Topic++
Re: Documentation and Topic++ [message #12724 is a reply to message #12720] |
Wed, 14 November 2007 11:46 |
|
mirek
Messages: 13979 Registered: November 2005
|
Ultimate Member |
|
|
Mindtraveller wrote on Tue, 13 November 2007 22:32 | I think this is of course great to have one help engine for development docs and user (not programmer) documentation on application developed. So I vote for the original idea.
Next, from the design point of view, treeview-control guiding system as well as "predefined groups" seems to me not very optimal.
|
Yep, I agree. The help page definitely needsd an improvement.
Quote: |
I`ll try to make suggestions how to increase usability. Of course, everything below is my point of view and a subject for discussion:
1) Leving behind any "magical words" line "srcdocs","srcimp". We simply don`t need that kind of magic. We need simple things to concentrate attention to the help text itself - without user`s brain guiding through magical labyrinths.
|
Mostly agree, but I think medium advanced user will need to know those magic words too, so that he can use Topic++ to write docs...
Considering other points, the only thing I would like to add is the vision that the future ide will provide much better code/documentation integration.
One of ideas is that browsing the .h file, you will have small icons in left bar (when breakpoints usually are) for each code element (e.g. method declaration); moving the mouse over that icon will popup documentation for the item.
If documentation is not available for item, icon will look differently and clicking it will move you to topic++, generating the text template to document the method.
Similar capabilities should be available in new class browser too.
In .cpp, the idea is that instead of "src", these will lead to "srcimp".
Mirek
|
|
|
|
|
Documentation and Topic++
By: mirek on Tue, 13 November 2007 19:41
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 14 November 2007 11:46
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 14 November 2007 13:41
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Fri, 16 November 2007 12:05
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 04 December 2007 17:10
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 04 December 2007 23:32
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 05 December 2007 19:18
|
|
|
Re: Documentation and Topic++
By: Novo on Thu, 06 December 2007 20:05
|
|
|
Re: Documentation and Topic++
By: zsolt on Thu, 06 December 2007 21:05
|
|
|
Re: Documentation and Topic++
By: mirek on Thu, 06 December 2007 21:10
|
|
|
Re: Documentation and Topic++
By: Novo on Thu, 06 December 2007 21:49
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Thu, 13 December 2007 18:27
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Fri, 14 December 2007 17:17
|
|
|
Re: Documentation and Topic++
By: mrjt on Mon, 14 April 2008 11:27
|
|
|
Re: Documentation and Topic++
By: mirek on Mon, 14 April 2008 14:26
|
|
|
Re: Documentation and Topic++
By: mrjt on Mon, 14 April 2008 14:40
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 10 June 2008 18:35
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Thu, 12 June 2008 17:36
|
|
|
Re: Documentation and Topic++
By: zsolt on Thu, 12 June 2008 20:25
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mrjt on Thu, 12 June 2008 23:35
|
|
|
Re: Documentation and Topic++
By: mirek on Fri, 13 June 2008 09:36
|
|
|
Re: Documentation and Topic++
By: mirek on Fri, 13 June 2008 09:45
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Mon, 16 June 2008 13:00
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Mon, 16 June 2008 15:34
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Mon, 16 June 2008 19:38
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 18 June 2008 11:23
|
|
|
Re: Documentation and Topic++
By: mr_ped on Wed, 18 June 2008 11:39
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Mon, 16 June 2008 20:54
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 17 June 2008 00:55
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 18 June 2008 11:20
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 18 June 2008 13:22
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Wed, 18 June 2008 17:43
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Thu, 19 June 2008 15:00
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Sun, 06 July 2008 20:06
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Mon, 07 July 2008 22:15
|
|
|
Re: Documentation and Topic++
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 08 July 2008 16:11
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 08 July 2008 18:11
|
|
|
Re: Documentation and Topic++
By: mr_ped on Tue, 17 June 2008 11:59
|
|
|
Re: Documentation and Topic++
By: mirek on Tue, 17 June 2008 13:40
|
Goto Forum:
Current Time: Sun May 12 22:45:14 CEST 2024
Total time taken to generate the page: 0.02806 seconds
|