Discussion on: How do you create entities?

I've written code like that. Say my system creates a new user with the username that they selected

addUser(name);

And it's cool. After all, a username is a required field so it makes sense that an interface for creating a user should take the name. But then we decided oh hey we want some other fields to be required

addUser(name, email);
addUser(name, email, ... );

And everytime our spec changes we just tack on a new method.
If your spec doesn't change, I think it's fine, but of course if it does change, code gets messy.

When I was coding in python, I came across keyword-arguments

addEmployee(name=yourName, email=yourEmail, ...)

If the language doesn't support that syntax natively, just pass in like a map

addEmployee( array( "name" => $yourName, "email" => $yourEmail" ));

Kind of thing. Of course it doesn't solve the problem if you have NEW required fields because I still need to go out there and change all calls to addEmployee, but at least by taking an object of values I don't need to worry about changing method signatures which breaks every code out there if I wanted to add a new field.

But I think if you're changing a method signature, it's probably a big enough change that all the callers need to be changed as well.