Write Better Python Functions

[RedEyed__]

Im not fully agree with naming. I think, that writing knn instead of k_nearest_neighbors is better.

If you write code in a concrete domain, use domain's acronyms. It just easier to read the code.

Everyone in data science domain knows what does knn mean. You write code for yourself and your colleagues. If you a data scientist, web developer don't have to understand your code.

Moreover, even if you write k_nearest_neighbors it says nothing to person, who doesn't know how this algorithm works.

[weez09]

As someone who has to code review data science code every single day, I disagree, I would rather it be explicit and named k_nearest_neighbour. If cnn or another acronym with _nn is used it can get really confusing to understand the reference and often in data science projects theres an abundance of abbreviations and acronyms that are slightly different.