New answers tagged

0 votes

Fighting the half-life of code

At one point I was working in a small company which can be best described of making a living of doing Agile COBOL development. A customer specific request of an alteration of their standard product ...
user avatar
1 vote

Fighting the half-life of code

I think you are approaching this wrong. 10 years isn't a long time for Microsoft, IBM or Oracle. Stuff you wrote in VB6 or Java 10 years ago will still run on the latest version of windows today. ...
user avatar
  • 65k
-2 votes
Accepted

Fighting the half-life of code

If its not too complex for sure JavaScript and HTML (and preferably within one file). Browsers need to have A LOT of backwards compatibility. I’m pretty sure if you keep to normal logic all your forms ...
user avatar
  • 326
7 votes

Fighting the half-life of code

Choose a popular programming language The more people that know the language the better the odds someone who wishes to replicate your work will know the language. By popular I mean new graduates in ...
user avatar
9 votes

Fighting the half-life of code

Disclaimer: I am a guy who leads a team which maintains > 100 programs, where most of them have a long history, several of them much longer than just 10 years. From that experience, I can tell you ...
user avatar
  • 186k
-3 votes

Fighting the half-life of code

I think your premise is wrong. In ten years no one will be interested in running your code. More likely someone will want to redo it on a different platform, implementing logic that matters then. If ...
user avatar
  • 16.1k
3 votes

Fighting the half-life of code

I think you're right to look back (say) 10 years into the past. The languages which were around then and are still mostly unchanged today are the "boring" ones: C, C++, Java. If you took a ...
user avatar
0 votes

Should docs of extended methods include documentation of the base method?

This very much depends on context. Will the reader of the documentation know/care about the base class and its working? For example, if this documentation is intended for developers who need active ...
user avatar
  • 38.3k
1 vote

Should docs of extended methods include documentation of the base method?

The main problem here is that seemingly you don't specify some_method's contract, but only its implementations (guessing from the text in the documentation strings). And that means that you break the ...
user avatar
0 votes

Should docs of extended methods include documentation of the base method?

There are cases where I don’t care about any class hierarchy. If I show a Button on the screen I care that it is a button, not what it’s base class is. And I would like goto have documentation that ...
user avatar
  • 38.3k
0 votes
Accepted

Should docs of extended methods include documentation of the base method?

Lets stick to your example: the docstring in the child class could be either """ This method does A and B, followed by C """ or """ ...
user avatar
  • 186k
2 votes

Should docs of extended methods include documentation of the base method?

Your method does something. Document that. How it does that, whether it calls another method or not, whether that method is its own supermethod or not, is nobody's business. Document what your method ...
user avatar

Top 50 recent answers are included