search

se-edu / se-book

:book: Online Book: Software Engineering for Self-Directed Learners
https://se-edu.github.io/se-book/
42 stars 32 forks source link

Inconsistency with source material: SLAP #101

Closed ianyong closed 3 years ago

ianyong commented 3 years ago

In the textbook, it is stated that SLAP stands for:

Single Level of Abstraction Per method

However, the source material, The Productive Programmer by Neal Ford, states the following instead:

Single Level of Abstraction Principle

Not sure if this is an intentional deviation from the source material since the textbook's version is more descriptive.

Link to the relevant section in the CS2103T AY20/21 S1 textbook.

damithc commented 3 years ago

IIRC, I took the name used by the original author Robert C. Martin (in Clean Code), which is Single Level of Abstraction Per Function and replaced Function with Method to suit Java. Single Level of Abstraction Principle sounds nicer, but I think function/method is an important part of the technique. Can probably mention both names. Will do so in the next semester version.

damithc commented 3 years ago

Fixed.