Coder Social home page Coder Social logo

Comments (7)

ryanmcdermott avatar ryanmcdermott commented on May 3, 2024 1

You know what, you're right. It should say showEmployeesList! Want to make a PR?

from clean-code-javascript.

AnnaNee avatar AnnaNee commented on May 3, 2024

Sure!

from clean-code-javascript.

hueitan avatar hueitan commented on May 3, 2024

The other examples give

showDeveloperList without (s)
showManagerList without (s)

and now we use showEmployeesList with (s)

which is the best case?

from clean-code-javascript.

AnnaNee avatar AnnaNee commented on May 3, 2024

Haven't thought about that. I usually use in the plural form when a certain method has many properties as a result, so showEmployeesList(). But to talk about the best practices I can't say which is better. In the other hand, in order to keep consistency, I think we should change to showEmployeeList().

What you think?

from clean-code-javascript.

ryanmcdermott avatar ryanmcdermott commented on May 3, 2024

This gets into a bit of linguisitics, which is off in the weeds away from Clean Code, but a noun pre-modifier is usually singular: Grocery List, Customer List, Client List, etc. I think showEmployeeList would be both consistent with the document and with the language 🤓 I could be comfortable with either, but let's just make it consistent then. Thanks for putting so much time into picking good names! Half of programming skill is about naming and organization.

from clean-code-javascript.

hueitan avatar hueitan commented on May 3, 2024

Half of programming skill is about naming and organization.

😂 indeed.

I also agree with either, as long as your team approve with the naming.

from clean-code-javascript.

AnnaNee avatar AnnaNee commented on May 3, 2024

I'll change it to showEmployeeList() then. Thanks @hueitan for pointing that out. ;)

from clean-code-javascript.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.