Click here to Skip to main content
15,886,919 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!

 
NewsWhy scientists are worried about the W Boson: 'Something is amiss' Pin
Kent Sharkey10-Apr-22 6:31
staffKent Sharkey10-Apr-22 6:31 
NewsSecret government info confirms first known interstellar object on Earth, scientists say Pin
Kent Sharkey7-Apr-22 10:46
staffKent Sharkey7-Apr-22 10:46 
GeneralRe: Secret government info confirms first known interstellar object on Earth, scientists say Pin
MarkTJohnson8-Apr-22 9:16
professionalMarkTJohnson8-Apr-22 9:16 
GeneralRe: Secret government info confirms first known interstellar object on Earth, scientists say Pin
Daniel Pfeffer9-Apr-22 7:04
professionalDaniel Pfeffer9-Apr-22 7:04 
NewsWhy literate programming might help you write better code Pin
Kent Sharkey7-Apr-22 9:46
staffKent Sharkey7-Apr-22 9:46 
GeneralRe: Why literate programming might help you write better code Pin
David O'Neil7-Apr-22 15:42
professionalDavid O'Neil7-Apr-22 15:42 
GeneralRe: Why literate programming might help you write better code PinPopular
Bernhard Hiller7-Apr-22 20:48
Bernhard Hiller7-Apr-22 20:48 
GeneralRe: Why literate programming might help you write better code Pin
Greg Utas8-Apr-22 6:05
professionalGreg Utas8-Apr-22 6:05 
The only content that I gleaned, apart from platitudes and mentions of various people and tools related to "literate programming", was that code should be documented inline, using natural language. And that this has become popular in statistics and data science programs. Well, duh. How those results are derived has to be described at the algorithmic level, to show the mathematics involved, but this is just fancy number crunching.

Although I almost always write proper sentences to document interfaces or functions, doing this inline doesn't work at the architectural level, where the rationale for a design cuts across code boundaries. Now you need separate documents, which these people say are a pain to keep synchronized with the code. Yes, but so are inline comments. More than once, I find outdated comments that I forgot to update when changing something.

And although I didn't verify this, it appears that they mark up these natural language comments. No thanks. I don't want to filter out this noise from the comments. I suppose it would work if the comments were displayed in a pane alongside the code, but that locks you into a specific IDE, which is presumptuous when other people are going to be using the code. Things like Doxygen make me puke.
Robust Services Core | Software Techniques for Lemmings | Articles
The fox knows many things, but the hedgehog knows one big thing.

GeneralRe: Why literate programming might help you write better code Pin
David O'Neil8-Apr-22 6:33
professionalDavid O'Neil8-Apr-22 6:33 
GeneralRe: Why literate programming might help you write better code Pin
trønderen8-Apr-22 11:40
trønderen8-Apr-22 11:40 
NewsSurvey ahows increased focus on modernizing IT, retiring apps Pin
Kent Sharkey7-Apr-22 9:46
staffKent Sharkey7-Apr-22 9:46 
GeneralRe: Survey ahows increased focus on modernizing IT, retiring apps Pin
Nelek8-Apr-22 11:20
protectorNelek8-Apr-22 11:20 
NewsRust 2024 roadmap focuses on developer ease of use Pin
Kent Sharkey7-Apr-22 8:01
staffKent Sharkey7-Apr-22 8:01 
GeneralRe: Rust 2024 roadmap focuses on developer ease of use Pin
raddevus8-Apr-22 5:03
mvaraddevus8-Apr-22 5:03 
NewsProject “Zuck Bucks”: Meta plans virtual coin after cryptocurrency flop Pin
Kent Sharkey7-Apr-22 8:01
staffKent Sharkey7-Apr-22 8:01 
GeneralRe: Project “Zuck Bucks”: Meta plans virtual coin after cryptocurrency flop Pin
obermd8-Apr-22 3:24
obermd8-Apr-22 3:24 
NewsAnnouncing .NET Community Toolkit v8.0.0 Preview 3 Pin
Kent Sharkey7-Apr-22 6:31
staffKent Sharkey7-Apr-22 6:31 
NewsWindows 11's new security feature is so secure you'll need to reinstall the OS to use it Pin
Kent Sharkey7-Apr-22 6:31
staffKent Sharkey7-Apr-22 6:31 
GeneralRe: Windows 11's new security feature is so secure you'll need to reinstall the OS to use it Pin
Daniel Pfeffer8-Apr-22 0:32
professionalDaniel Pfeffer8-Apr-22 0:32 
GeneralRe: Windows 11's new security feature is so secure you'll need to reinstall the OS to use it Pin
Dan Neely8-Apr-22 3:26
Dan Neely8-Apr-22 3:26 
NewsArtificial Intelligence For CEOs Pin
Kent Sharkey7-Apr-22 6:16
staffKent Sharkey7-Apr-22 6:16 
GeneralRe: Artificial Intelligence For CEOs Pin
GuyThiebaut7-Apr-22 22:21
professionalGuyThiebaut7-Apr-22 22:21 
GeneralRe: Artificial Intelligence For CEOs Pin
Nelek8-Apr-22 11:24
protectorNelek8-Apr-22 11:24 
NewsCan you name top C# IDEs provided by Microsoft? Pin
Kent Sharkey6-Apr-22 10:01
staffKent Sharkey6-Apr-22 10:01 
NewsWindows 3.1 is officially 30 years old Pin
Kent Sharkey6-Apr-22 9:46
staffKent Sharkey6-Apr-22 9:46 

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.