Tag Info

New answers tagged

3

Note: I am not very familiar with ABAP, so I am answering as if someone asked about using lambdas in Java, in the understanding that the issue is similar (AFAIK it is). If I am wrong, please inform me. This does not belong to comments (part of the code) as it is an specification issue of the project. In fact, it should not be a programmer who decides to use ...


1

In one respect I think this is a bit of an X-Y problem. For the sake of my example I'd like anyone reading this to consider C++'s recent C++11 overhaul. In particular I would like to focus on the constexpr operator. It's purpose is to allow certain functions to be run by the compiler (e.g. a factorial function) at compile time, thus preventing constant ...


19

In the context of ABAP you can rarely expect everyone to be familiar with all the newest features because: ABAP has such a long history and the ancient language constructs are still encountered all the time (I am currently modifying a report which uses a logical database and makes excessive use of tables with header lines). SAP themselves rarely uses the ...


7

In this case, someone unfamiliar with the updates could simply look up line_exists and move along. For something less searchable, you might want to leave a comment which simply names the new features you are using so that up-to-date documentation is easier to find. If you use these features in more than a few places, put such a notice in a readme file ...


26

Contrary to other answers, I would say no. The code should be self-documented as much as possible. Such simple things should not need to be explained in the code. I do not know SAP, but a simple google query pointed to the SAP reference page to the line_exists function. If the maintainers and developers are not up to date, then the company needs to develop ...


8

I think it depends on the situation. In this example, documentation like this belongs in a README file.* If you consistently use the new syntax, your code will be virtually unrecognizable to a programmer who only knows the older style. Your maintainers will thank you if you warn them up front that they don't actually know this language. I would: Start ...



Top 50 recent answers are included