U++ forum: Welcome to the forum

Status & Roadmap

Authors & License

Funding Ultimate++

Search on this site

Search in forums

Home » Developing U++ » U++ Developers corner » U++ talk

Show: Today's Messages :: Show Polls :: Message Navigator
E-mail to friend

Return to the default flat view

Create a new topic

Submit Reply

Re: U++ talk [message #17922 is a reply to message #17917]

Tue, 02 September 2008 23:37

amrein is currently offline

amrein
Messages: 278
Registered: August 2008
Location: France

Experienced Member

Quote:

It's not about creating translation (current system is working great) as contributing documentation. Someone has to write the documentation directly in the source code. That means write access is needed, plus someone has to test that it still compiles.

At present, people use topic++ right? They save the doc in external files. What I said: do exactly the same process. The document manager (not his subordinates) can have a look into the topic++ work (what his subordinate, those without write access to the code, have done) than, if he think that all is ok, he presses a topic++ button and all validated modifications are synchronized back into the source file, ready for doxygen and U++ final release.

Quote:

If user doesn't have write access, somebody needs to merge the changes for him.

Yes, modifications has to be validated. U++ API can break at any time before final release. Two eyes are better than one. You keep total control of the final documentation submitted but your contributors have full access to the topic++ generated documentation.

Quote:

Also, after every doc commit, people will have to recompile their sources and run doxygen on them. And if you distribute prebuilt documentation, you basically are back to square one.

If they don't want to edit the topic++ output, and want the last doxygen output then yes. What prevent them from using topic++ to see the unstable doc? Nothing. How could the topic++ documentation break the source if the integration process is automated by topic++?

Report message to a moderator

Send a private message to this user

[Message index]

		U++ talk By: amrein on Mon, 01 September 2008 14:43
		Re: Does the provided upp.spec works for you and on which distro? By: cbpporter on Mon, 01 September 2008 15:00
		Re: Does the provided upp.spec works for you and on which distro? By: guido on Mon, 01 September 2008 23:32
		Re: Does the provided upp.spec works for you and on which distro? By: amrein on Tue, 02 September 2008 11:38
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Tue, 02 September 2008 14:22
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Tue, 02 September 2008 10:06
		Re: Does the provided upp.spec works for you and on which distro? By: amrein on Tue, 02 September 2008 12:45
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Tue, 02 September 2008 13:53
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Tue, 02 September 2008 14:17
		Re: Does the provided upp.spec works for you and on which distro? By: cbpporter on Tue, 02 September 2008 14:19
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Tue, 02 September 2008 14:29
		Re: Does the provided upp.spec works for you and on which distro? By: captainc on Tue, 02 September 2008 16:22
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Wed, 10 September 2008 19:26
		Re: Does the provided upp.spec works for you and on which distro? By: mirek on Wed, 03 September 2008 09:49
		Re: U++ talk By: amrein on Tue, 02 September 2008 20:47
		Re: U++ talk By: mirek on Tue, 02 September 2008 21:23
		Re: U++ talk By: mirek on Tue, 02 September 2008 21:24
		Re: U++ talk By: amrein on Tue, 02 September 2008 22:20
		Re: U++ talk By: mirek on Tue, 02 September 2008 23:20
		Re: U++ talk By: cbpporter on Tue, 02 September 2008 22:30
		Re: U++ talk By: mirek on Tue, 02 September 2008 23:22
		Re: U++ talk By: amrein on Tue, 02 September 2008 23:37
		Re: U++ talk By: captainc on Wed, 03 September 2008 03:44
		Re: U++ talk By: mirek on Wed, 03 September 2008 09:58
		Re: U++ talk By: cbpporter on Wed, 03 September 2008 10:23
		Re: U++ talk By: mirek on Wed, 03 September 2008 11:10
		Re: U++ talk By: amrein on Wed, 03 September 2008 18:52
		Re: U++ talk By: mirek on Wed, 03 September 2008 22:55
		Re: U++ talk By: mirek on Wed, 03 September 2008 23:00
		Re: U++ talk By: cbpporter on Thu, 04 September 2008 04:52
		Re: U++ talk By: mr_ped on Thu, 04 September 2008 09:30
		Re: U++ talk By: mirek on Thu, 04 September 2008 12:45
		Re: U++ talk By: amrein on Thu, 04 September 2008 13:41
		Re: U++ talk By: mirek on Thu, 04 September 2008 21:55
		Re: U++ talk By: amrein on Thu, 04 September 2008 13:38
		Re: U++ talk By: mirek on Thu, 04 September 2008 21:54
		Re: U++ talk By: amrein on Thu, 04 September 2008 23:06
		Re: U++ talk By: amrein on Thu, 04 September 2008 23:28
		Re: U++ talk By: Mindtraveller on Sun, 07 September 2008 23:34
		Re: U++ talk By: Novo on Mon, 08 September 2008 05:01
		Re: U++ talk By: mirek on Mon, 08 September 2008 08:23
		Re: U++ talk By: Mindtraveller on Mon, 08 September 2008 09:22
		Re: U++ talk By: mr_ped on Mon, 08 September 2008 11:16

Previous Topic:	Assist - rescan code vs caching in files....
Next Topic:	Upp Idea -> MultiTouch support

Goto Forum:

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

] [

PDF

]

Current Time: Sun Aug 24 20:20:23 CEST 2025

Total time taken to generate the page: 0.07431 seconds