How about another language?

[DarkS474]

@kjustynski;722983

I used word “mythical” with “full documentation” because you never gonna get such thing.

1. Working on good docs takes at least the same as implementation itself. And you need skill for that - it’s not easy for every developer to explain everything clearly, even for beginners. That’s normal for every big piece software - if you would make your team to document everything, product/service would be developed like 2x slower.
2. And engine changes every day. It’d be incredible effort to keep docs updated all the time. More time spent on docs than development. That’s unacceptable in such competitive industry.
3. Even simple design docs for game become outdated after few days and nobody has time to correct it. This is developer’s reality.

Sorry but that is just nonsense.
Apple documents on Swift and Objective-C APIs have been updated continously and with Swift they are still changing many things with APIs getting deprecated all the time. Still they update documents properly.

Do you seriously believe that millions of lines of code can be mantained by any programmer without having reference documents of everything that exists in the APIs written over the years? Any software house must have those internally otherwise there is no chance for programmers to synch their work and remember everything.