Click here to Skip to main content
15,899,126 members

Survey Results

When you read documentation on a new language, what's important?

Survey period: 1 Nov 2021 to 8 Nov 2021

You're moving to a new language. What do you absolutely, positively need? 1 = Not important, 5 = Absolutely gotta have it. (Something missing? Add it in a comment!)

OptionVotes12345 
A comprehensive list of all the keywords, operators, built in functions and features of the language5706%6%18%25%44%
Comprehensive docs on the main / most common libraries used with the language5705%10%25%32%27%
Beginner tutorials5706%9%20%25%39%
Template apps to get me started57010%15%27%28%19%
Information on not just what things do, but why they do it5709%16%30%27%16%
Information on when to use certain functionality (not just that the functionality exists)5708%10%31%32%18%
A quick reference for everything. I just need a reminder on syntax / parameters5705%6%21%29%38%
Examples of how to deal with common errors5705%8%33%34%18%
Architecture Best Practices (how do I structure a new app properly?)5706%11%31%26%25%



 
AnswerRe: The opposite of .NET documentation Pin
Member 154204095-Nov-21 18:51
Member 154204095-Nov-21 18:51 
GeneralRe: The opposite of .NET documentation Pin
Member 154204095-Nov-21 18:51
Member 154204095-Nov-21 18:51 
AnswerRe: The opposite of .NET documentation Pin
Member 154207646-Nov-21 4:16
Member 154207646-Nov-21 4:16 
GeneralRe: The opposite of .NET documentation Pin
Member 154207646-Nov-21 4:16
Member 154207646-Nov-21 4:16 
AnswerRe: The opposite of .NET documentation Pin
Member 154215797-Nov-21 2:40
Member 154215797-Nov-21 2:40 
GeneralRe: The opposite of .NET documentation Pin
Member 154215797-Nov-21 2:40
Member 154215797-Nov-21 2:40 
GeneralGive me basic syntax.... and google. Pin
harvyk02-Nov-21 11:36
harvyk02-Nov-21 11:36 
GeneralFormal language syntax defintion Pin
trønderen2-Nov-21 9:33
trønderen2-Nov-21 9:33 
This isn't relevant for several languages, because the definition is too bl**dy complex. But for simpler languages, it can be a great aid to really understand all aspects of a language.

In the old days, when I learned Pascal (which is certainly not too complex for a formal definition), I learned a whole lot by studying the 'blob-and-arrow' diagrams for the syntax. For other languages, I still search for a BNF definition of sorts - it is still helpful for data definition languages (langages are a lot more than loops and if-else-constructs!). For communication languages (a.k.a. protocols), MCSs may be very helpful to understand the language.

Part of the reason why formal specifications are rarely seen today is that you can't take for granted that today's young programmers are familiar with any formal specification language, not even basic BNF. If they were to read a formal specification, they would have had to learn the specification language first, before learning the programming language!
GeneralRe: Formal language syntax defintion Pin
den2k882-Nov-21 22:25
professionalden2k882-Nov-21 22:25 
GeneralA YouTube Video Pin
Amarnath S2-Nov-21 6:11
professionalAmarnath S2-Nov-21 6:11 
GeneralRe: A YouTube Video Pin
trønderen2-Nov-21 9:07
trønderen2-Nov-21 9:07 
GeneralRe: A YouTube Video Pin
Amarnath S2-Nov-21 16:21
professionalAmarnath S2-Nov-21 16:21 
GeneralRe: A YouTube Video Pin
den2k882-Nov-21 22:24
professionalden2k882-Nov-21 22:24 
GeneralConclusion so far: Everything is pretty important, but not an absolute requirement Pin
trønderen2-Nov-21 0:42
trønderen2-Nov-21 0:42 
GeneralI just discovered by accident ... Pin
trønderen2-Nov-21 5:56
trønderen2-Nov-21 5:56 
GeneralRe: I just discovered by accident ... Pin
  Forogar  4-Nov-21 4:15
professional  Forogar  4-Nov-21 4:15 
GeneralList of why language is better than C++ and C# Pin
John Stewien1-Nov-21 23:39
John Stewien1-Nov-21 23:39 
GeneralRe: List of why language is better than C++ and C# Pin
trønderen2-Nov-21 0:33
trønderen2-Nov-21 0:33 
GeneralRe: List of why language is better than C++ and C# Pin
JP Reyes2-Nov-21 6:28
JP Reyes2-Nov-21 6:28 
GeneralRe: List of why language is better than C++ and C# Pin
John Stewien2-Nov-21 17:50
John Stewien2-Nov-21 17:50 
GeneralRe: List of why language is better than C++ and C# Pin
den2k883-Nov-21 1:10
professionalden2k883-Nov-21 1:10 
GeneralRe: List of why language is better than C++ and C# Pin
John Stewien3-Nov-21 2:11
John Stewien3-Nov-21 2:11 
GeneralRe: List of why language is better than C++ and C# Pin
Richard Andrew x646-Nov-21 3:27
professionalRichard Andrew x646-Nov-21 3:27 
GeneralRe: List of why language is better than C++ and C# Pin
NPowDev3-Nov-21 2:19
NPowDev3-Nov-21 2:19 
GeneralBeginner tutorial + Pin
Stepan Hakobyan1-Nov-21 22:23
professionalStepan Hakobyan1-Nov-21 22:23 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.