Click here to Skip to main content
15,891,896 members

The Insider News

   

The Insider News is for breaking IT and Software development news. Post your news, your alerts and your inside scoops. This is an IT news-only forum - all off-topic, non-news posts will be removed. If you wish to ask a programming question please post it here.

Get The Daily Insider direct to your mailbox every day. Subscribe now!

 
GeneralRe: The cost of interruption for software developers Pin
Nelek22-Jul-19 2:48
protectorNelek22-Jul-19 2:48 
NewsIs the C# internal keyword a code smell? Pin
Kent Sharkey21-Jul-19 8:16
staffKent Sharkey21-Jul-19 8:16 
GeneralRe: Is the C# internal keyword a code smell? PinPopular
Joe Woodbury21-Jul-19 8:19
professionalJoe Woodbury21-Jul-19 8:19 
GeneralRe: Is the C# internal keyword a code smell? Pin
Kent Sharkey21-Jul-19 8:20
staffKent Sharkey21-Jul-19 8:20 
GeneralRe: Is the C# internal keyword a code smell? Pin
Bernhard Hiller21-Jul-19 22:48
Bernhard Hiller21-Jul-19 22:48 
GeneralRe: Is the C# internal keyword a code smell? Pin
TheGreatAndPowerfulOz22-Jul-19 6:16
TheGreatAndPowerfulOz22-Jul-19 6:16 
NewsTo create effective API documentation, know how developers use it, says ACM Pin
Kent Sharkey21-Jul-19 8:16
staffKent Sharkey21-Jul-19 8:16 
GeneralRe: To create effective API documentation, know how developers use it, says ACM Pin
Mark_Wallace22-Jul-19 12:33
Mark_Wallace22-Jul-19 12:33 
Jeeze, Louise.

To clarify what the article most definitely did not (in fact, it made a confusing mess of it all):

There are two types of API documentation:

0. The in-line documentation, which is written as comments as you write the code (and which no-one but the dev who writes the code has control over)

1. The programming-guide API doc, which has to be written by someone who not only understands the code, but who knows how to construct and write documentation (99.999 of developers need not apply).

Type 0 is used for:

10. Trial-and-error programming, where you know where to go, but you're flying by the seat of your pants, where the possibilities of the API are concerned.

11. Finding details like what parameters are available/must be used, when you've already got a good knowledge of the API.

Type 1 is used for:

20. Getting an overall feel of the API.

21. Seeing API functions in use.

22. Seeing how API functions can be combined to perform complex actions that are performed often, and how to use API calls in sequence to do the kind of thing we do every day with programming languages.

It is clear that the article addresses only type 0, so, from my perspective, only talks about developers who have been given far too little information to use the API.

Ergo, the article's conclusions are underinformed nonsense.
I wanna be a eunuchs developer! Pass me a bread knife!

NewsThis pixel tracking demo shows how easy it is to make a creepy surveillance tool Pin
Kent Sharkey21-Jul-19 8:16
staffKent Sharkey21-Jul-19 8:16 
GeneralRe: This pixel tracking demo shows how easy it is to make a creepy surveillance tool Pin
Bernhard Hiller21-Jul-19 22:56
Bernhard Hiller21-Jul-19 22:56 
GeneralRe: This pixel tracking demo shows how easy it is to make a creepy surveillance tool Pin
Dan Neely22-Jul-19 2:38
Dan Neely22-Jul-19 2:38 
GeneralRe: This pixel tracking demo shows how easy it is to make a creepy surveillance tool Pin
Mark_Wallace22-Jul-19 12:41
Mark_Wallace22-Jul-19 12:41 
NewsForget IOT - it's time for IOD Pin
Ravi Bhavnani19-Jul-19 10:17
professionalRavi Bhavnani19-Jul-19 10:17 
GeneralRe: Forget IOT - it's time for IOD Pin
Rick York19-Jul-19 10:43
mveRick York19-Jul-19 10:43 
GeneralRe: Forget IOT - it's time for IOD Pin
abmv20-Jul-19 6:13
professionalabmv20-Jul-19 6:13 
GeneralRe: Forget IOT - it's time for IOD Pin
Mark_Wallace20-Jul-19 21:04
Mark_Wallace20-Jul-19 21:04 
GeneralRe: Forget IOT - it's time for IOD Pin
Kent Sharkey21-Jul-19 8:18
staffKent Sharkey21-Jul-19 8:18 
GeneralRe: Forget IOT - it's time for IOD Pin
Ravi Bhavnani21-Jul-19 14:56
professionalRavi Bhavnani21-Jul-19 14:56 
GeneralRe: Forget IOT - it's time for IOD Pin
Mark_Wallace22-Jul-19 12:43
Mark_Wallace22-Jul-19 12:43 
GeneralRe: Forget IOT - it's time for IOD Pin
Dan Neely22-Jul-19 2:39
Dan Neely22-Jul-19 2:39 
NewsA Rust-based TLS library outperformed OpenSSL in almost every category Pin
Kent Sharkey21-Jul-19 18:01
staffKent Sharkey21-Jul-19 18:01 
GeneralRe: A Rust-based TLS library outperformed OpenSSL in almost every category Pin
Mark_Wallace22-Jul-19 12:44
Mark_Wallace22-Jul-19 12:44 
NewsMicrosoft begins testing Windows 10 controlled feature rollout Pin
Kent Sharkey21-Jul-19 18:01
staffKent Sharkey21-Jul-19 18:01 
GeneralRe: Microsoft begins testing Windows 10 controlled feature rollout Pin
Nelek22-Jul-19 2:09
protectorNelek22-Jul-19 2:09 
GeneralRe: Microsoft begins testing Windows 10 controlled feature rollout Pin
Mark_Wallace22-Jul-19 12:51
Mark_Wallace22-Jul-19 12:51 

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.