Click here to Skip to main content
15,893,594 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%



 
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 
In a non-hobbyist setting, that may be be important to you, your company or your customer(s). Frequently (maybe in most cases, this is strongly affected by factors unrelated to the technical language properties, and you are not likely to find it in the documentation on the language.

I've learned new languages: When the company decided to switch to a less used language to protect their IP rights in case the source code was stolen. When entering a new position, and a management decision had been made about language choice before I entered. When getting the responsibility for maintaining existing software in a language new to me. When the context, such as html, restricted the languages available. When a test framework was introduced where test procedures was written in a language new to me. When direct interface to hardware was required, so I had to learn another assembly language. When I had to modify the system build functionality of the 'editor' (well, some people say that emacs is a good OS, but it lacks a decent editor ...).

I have experienced all of these situations. I can imagine several others: A needed library may available only in a specific language (years ago, IBM had some great graphics software in APL). Your customer is buying the source code, dictating your language selection. Your team are experts in a domain specific language new to you. ... We could probably dig up a dozen other examples of restrictions not related to the language itself, but to your specific context.

The language documentation may of course boast: This is the perfect language for everything! without going into any specifics, or only things unrelated to your specific situation (such as 'You can program your editor's behavior', which is irrelevant if your editor is non-programmable or only in another language).

As a hobbyist, you have a great freedom to pick the language of your choice. A small one-man or few-men company restricted to a small class of software, such as small freestanding closed-source applications, interfacing with other software only through IP based protocols (or not at all) may have a similar freedom. And, you have the freedom to shy away from employers expecting you to program in languages other than those you already know.
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.