|
==Названия методов==
Из -за того, что методы, которые помещаются на экране, более легкилегче для понимания, не имеет смысла уменьшать понятностьих приясность, помощииспользуя неясныхнепонятные имён. Используйте имена для методов и переменных, которые поточны возможностии ясныподробны настолько, насколько это возможно. Не используйтесокращайте аббревиатурслова, если онитолько это не стандартныстандартные дляаббревиатуры, всехпонятные всем, кто работает в проекте. Так как вы не пишитечасто определяете имена в Смолток очень частоSmalltalk, не повредит иметь длинные имена, которые подробны и понятны.
<!--
-->
Имена методов должны говорить о том, что метод делает метод. Не экономьте буквы; более важна ясность имени, чем его длинна. Программист должен быть способен, посмотрев на кодметод и прочитав его имя, немедленно сказать, что он делает, просто прочитав имя. Однако, не всегда просто подобрать хорошее имя, когда вы просто смотрите на метод. Оно может прийти на ум, когда вы вызываете метод, посылая ему сообщение. Так что, даже если имя кажется подходящим, пока вы описываете метод, будьте готовы вернуться и исправить имя после использования его в других методах.
<!--
Method names should say exactly what the method does. Don't be stingy with the number of characters; it's more important to be understandable than short. A programmer should be able to pick up someone else's code and immediately know what the method does, just be reading the name. However, it's not always easy to come up with a great method name when you are looking at the method itself. It's when the method is being invoked, when you are doing the message send, that you'll get the best idea of how good the name is. If it makes sense in the context where it is sent, then you've probably got a good name. So, while it's okay to name the method when you are writing it, be prepared to go back and change the name after you use it in other methods.
|
