Re: Ada syntax questions

[DrPi <314@drpi.fr>]

Le 19/12/2020 à 22:51, Stephen Leake a écrit :
> DrPi <314@drpi.fr> writes:
> 
>> Reading the code can't tell you the writer's intentions.
> 
> That's what comments and design documents are for.
> 

A good IDE with code analysis showing you object declaration/use is very 
useful. Especially when comments are out of sync with the code.

I'm surprised that no modern tool/language allows the programmer to 
embed a "complete" documentation in source files.
I'm not talking about comments formatted to suit a specific tool 
convention, like Python or Perl doc-strings.
I' talking about embedding schematics, drawings, bitmaps, mathematical 
equations, etc directly in the source code.
Or maybe the reverse : embed source code in standard document. Like 
javascript in SVG files.
Why not a .odt file with code sections ? Ok, a specific file format 
would be better.
Of course, the editor should be specific. Not more a simple text editor.