Re: Another question re documentation style

new topic     » goto parent     » topic index » view thread      » older message » newer message

You might could make this one minor change for technical correctness*:

irv said...

Let's do it right:

include std/datetime.e 
 
-- object dt = now()  
datetime dt = now() 
 
? dt -- display the results 

Output:

{2019,9,7,17,30,38}

And that, friends, is why locking the documentation into source code where it can't be changed is a bad idea.

We need some way to keep docs in the source, just for the fact that the source programmers have the best insight; maybe we could just output an outline so that the documentation managers can make sure they cover every base. We could also make a provision, at least for the online docs, to have comments. These could then be incorporated into the docs and marked appropriately (maybe allow ticket creation straight from the docs pages?).

* which, I've heard, is the best kind of correctness. grin

ADDED: It would be cool, also, to show more advanced (or useful) output with format() to get a human-readable date, and even a translation to another language!

new topic     » goto parent     » topic index » view thread      » older message » newer message

Search



Quick Links

User menu

Not signed in.

Misc Menu