LINUX.ORG.RU

История изменений

Исправление www_linux_org_ru, (текущая версия) :

do_something_really_really_interesting(very_descriptive_parameter_name, another_important_parameter, dont_forget_about_me_too)

тут да, описание вида 

do_something_really_really_interesting(
    very_descriptive_parameter_name, 
    another_important_parameter,
    dont_forget_about_me_too
)

будет более читабельным, и читабельность не ухудшится, если мы сделаем там же описания 

do_something_really_really_interesting(
    very_descriptive_parameter_name, // дополнительное описание этого параметра
    another_important_parameter, // дополнительное описание этого параметра
    dont_forget_about_me_too // дополнительное описание этого параметра
)

и даже так 

do_something_really_really_interesting(

    very_descriptive_parameter_name, // дополнительное описание этого параметра
                                     // в несколько строчек
    another_important_parameter, // дополнительное описание этого параметра
                                 // в несколько строчек
    dont_forget_about_me_too // дополнительное описание этого параметра
                             // в несколько строчек
)

хотя я бы предпочел все равно

do_something_really_really_interesting($$$) = void {

    very_descriptive_parameter_name = MyClass(?); // дополнительное описание этого параметра
                                                  // в несколько строчек
    another_important_parameter = int(?); // дополнительное описание этого параметра
                                          // в несколько строчек
    dont_forget_about_me_too = bool(true); // дополнительное описание этого параметра
                                           // в несколько строчек

    ...
}

Исправление www_linux_org_ru, :

do_something_really_really_interesting(very_descriptive_parameter_name, another_important_parameter, dont_forget_about_me_too)

тут да, описание вида 

do_something_really_really_interesting(
    very_descriptive_parameter_name, 
    another_important_parameter,
    dont_forget_about_me_too
)

будет более читабельным, и читабельность не ухудшится, если мы сделаем там же описания 

do_something_really_really_interesting(
    very_descriptive_parameter_name, // дополнительное описание этого параметра
    another_important_parameter, // дополнительное описание этого параметра
    dont_forget_about_me_too // дополнительное описание этого параметра
)

и даже так 

do_something_really_really_interesting(

    very_descriptive_parameter_name, // дополнительное описание этого параметра
                                     // в несколько строчек
    another_important_parameter, // дополнительное описание этого параметра
                                 // в несколько строчек
    dont_forget_about_me_too // дополнительное описание этого параметра
                             // в несколько строчек
)

хотя я бы предпочел все равно

do_something_really_really_interesting($$$) = {

    very_descriptive_parameter_name = MyClass(?); // дополнительное описание этого параметра
                                                  // в несколько строчек
    another_important_parameter = int(?); // дополнительное описание этого параметра
                                          // в несколько строчек
    dont_forget_about_me_too = bool(true); // дополнительное описание этого параметра
                                           // в несколько строчек

    ...
}

Исправление www_linux_org_ru, :

do_something_really_really_interesting(very_descriptive_parameter_name, another_important_parameter, dont_forget_about_me_too)

тут да, описание вида 

do_something_really_really_interesting(
    very_descriptive_parameter_name, 
    another_important_parameter,
    dont_forget_about_me_too
)

будет более читабельным, и читабельность не ухудшится, если мы сделаем там же описания 

do_something_really_really_interesting(
    very_descriptive_parameter_name, // дополнительное описание этого параметра
    another_important_parameter, // дополнительное описание этого параметра
    dont_forget_about_me_too // дополнительное описание этого параметра
)

и даже так 

do_something_really_really_interesting(

    very_descriptive_parameter_name, // дополнительное описание этого параметра
                                     // в несколько строчек
    another_important_parameter, // дополнительное описание этого параметра
                                 // в несколько строчек
    dont_forget_about_me_too // дополнительное описание этого параметра
                             // в несколько строчек
)

Исходная версия www_linux_org_ru, :

do_something_really_really_interesting(very_descriptive_parameter_name, another_important_parameter, dont_forget_about_me_too)

тут да, описание вида 

do_something_really_really_interesting(
    very_descriptive_parameter_name, 
    another_important_parameter,
    dont_forget_about_me_too
)

будет более читабельным, и читабельность не ухудшится, если мы сделаем там же описания 

do_something_really_really_interesting(
    very_descriptive_parameter_name, // дополнительное описание этого параметра
    another_important_parameter, // дополнительное описание этого параметра
    dont_forget_about_me_too // дополнительное описание этого параметра
)

и даже так 

do_something_really_really_interesting(

    very_descriptive_parameter_name, // дополнительное описание этого параметра
                                     // в несколько строчек
    another_important_parameter, // описание этого параметра
                                 // в несколько строчек
    dont_forget_about_me_too // описание этого параметра
                             // в несколько строчек
)