Home » Developing U++ » U++ Developers corner » Documentation and Topic++
Re: Documentation and Topic++ [message #16440 is a reply to message #16437] |
Sun, 15 June 2008 19:03 |
mdelfede
Messages: 1307 Registered: September 2007
|
Ultimate Contributor |
|
|
I agree... IMHO the actual document structure isn't enough.
I'd prefere too a different approach, borland's user guides were very effective and comfortable to read... I think that could be a good example. Good old Microsoft guides in chm format were not bad at all too.
Maybe a good stuff would be to have a good underlying doc structure (maybe xml ?) ,separate viewer/browser AND separated doc editor.
We could even have more viewers, to accomodate user's preferences.
But, in my opinion, documents should be cathegorized, indexed and cross-referenced. Looking to a function/class should provide some "see-also" stuff, some examples, link to one or more main topics and so on.
And we should have cathegorized indexes.
Another good point would be to separate (as it was proposed sometimes) documentation from code, and give a more relaxed access to main repository's docs, allowing users to contribute more effectively.
We could even start a new sf project (with its svn repository) to hold just documentation for upp....
Max
|
|
|
|
|
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: Mon May 13 19:52:52 CEST 2024
Total time taken to generate the page: 0.02003 seconds
|