Keep removed tags on wiki pages?

Keep removed tags on wiki pages?

Various things about Spring that do not fit in any of the other forums listed below, including forum rules.

Moderator: Moderators

Post Reply
gajop
Moderator
Posts: 3051
Joined: 05 Aug 2009, 20:42

Keep removed tags on wiki pages?

Post by gajop »

Split from viewtopic.php?f=1&t=33366.

This one doesn't make sense. If it's always continuous (1), why is the default 0? Why is this even listed if it's removed?
int collisionVolumeTest Default: 0 Removed in 90.0 (Now always continuous)
The type of test used to detect collisions. Can be 0 (discrete) or 1 (continuous). Use the latter for catching high speed projectiles which may otherwise 'skip through' small collision volumes, but beware of the increased performance cost.
User avatar
jK
Spring Developer
Posts: 2299
Joined: 28 Jun 2007, 07:30

Re: Wiki: issues + quick questions/answers

Post by jK »

it was default 0, then changed to default 1 and then the tag was removed as a whole
Why is this even listed if it's removed?
Cause it's not auto-generated ?
gajop
Moderator
Posts: 3051
Joined: 05 Aug 2009, 20:42

Re: Wiki: issues + quick questions/answers

Post by gajop »

So should it be removed or have its default set to 1?
I'm asking because my version of boxxy still generates that and I wasn't sure if it still had any effect (sometimes tags are only deprecated, but not fully removed).
User avatar
jK
Spring Developer
Posts: 2299
Joined: 28 Jun 2007, 07:30

Re: Wiki: issues + quick questions/answers

Post by jK »

you got the source luke
User avatar
PicassoCT
Journeywar Developer & Mapper
Posts: 10450
Joined: 24 Jan 2006, 21:12

Re: Wiki: issues + quick questions/answers

Post by PicassoCT »

How to explain deep self inflicted laser wounds to your doctor - a Guide .pdf

might help
User avatar
FLOZi
MC: Legacy & Spring 1944 Developer
Posts: 6240
Joined: 29 Apr 2005, 01:14

Re: Wiki: issues + quick questions/answers

Post by FLOZi »

knorke (and possibly others) felt it better to maintain old doc for deprecated tags / lua API for those working on older engine versions etc.

So, for all those engine versions where the tag did (does?) exist, the default of 0 is correct.
8611
XTA Developer
Posts: 242
Joined: 29 Dec 2014, 08:22

Re: Wiki: issues + quick questions/answers

Post by 8611 »

gajop wrote:Why is this even listed if it's removed?
It is listed because answers questions like this:
gajop wrote:I wasn't sure if it still had any effect
If it was deleted from wiki then one could not be sure if it maybe just missing as an oversight.
Similiar if things change, like parameters being added to functions.

In theory such documenation would have resolved many discussions before they start. In practice it never worked because in this community a link to sourcecode or git history that shows something (like if a tag/variable is string or boolean) is a weaker arguement than "spring works in strange ways."
User avatar
Silentwings
Posts: 3720
Joined: 25 Oct 2008, 00:23

Re: Keep removed tags on wiki pages?

Post by Silentwings »

Afaics tags that are removed can be removed once they are removed, and tags that are deprecated/changed can be kept and marked deprecated/changed. The engine changelog is the place to record "removed XYZ", and the point of deprecation is that it gives time for games to update. In general I don't think we should support game development in long gone engine versions, and in most respects we don't.
User avatar
Forboding Angel
Evolution RTS Developer
Posts: 14673
Joined: 17 Nov 2005, 02:43

Re: Keep removed tags on wiki pages?

Post by Forboding Angel »

Silentwings wrote:The engine changelog is the place to record "removed XYZ".
Is a straight text file. Not a good place to have the only record of removals.
User avatar
Silentwings
Posts: 3720
Joined: 25 Oct 2008, 00:23

Re: Keep removed tags on wiki pages?

Post by Silentwings »

For what reason?

edit: Hmm - maybe it would be nicer to include links to source/commits. There is https://springrts.com/wiki/EngineChange ... ontentDevs.
gajop
Moderator
Posts: 3051
Joined: 05 Aug 2009, 20:42

Re: Keep removed tags on wiki pages?

Post by gajop »

I agree with Silentwings here. Things that are fully removed shouldn't be listed here. A wiki change log would be better.
User avatar
zwzsg
Kernel Panic Co-Developer
Posts: 7049
Joined: 16 Nov 2004, 13:08

Re: Keep removed tags on wiki pages?

Post by zwzsg »

On Love2d wiki they're super clear about added, deprecated, removed, and renamed API.
For example: http://www.love2d.org/wiki/SpriteBatch:addq

Image

Image

It would be great to have Spring API changes as nicely documented.

Then I understand you might feel Spring is different, or run a different wiki software, or that if I want that I should do it myself, whatever.
User avatar
PicassoCT
Journeywar Developer & Mapper
Posts: 10450
Joined: 24 Jan 2006, 21:12

Re: Keep removed tags on wiki pages?

Post by PicassoCT »

We are all bitches posting, waiting for the weakest one to give in and do the hard work..

I was wiikiadd once too you know - but then i took a edit to the knee..
Post Reply

Return to “General Discussion”