Dear developers,
First of all, thanks for all the tools out there that makes our biological research and data analysis possible.
Today, I just wanted to lay a constructive critique about source code commenting.
Please be kind and thouroughly comment your source codes for software and scripts following the pragmatic and style rules suggested by your programming language. Especially tell us what your subroutines do and what are the variables for.
#
//
I believe that this practice will contribute with our community which shares many different programming languages and levels of understanding among users.
Thank you for your consideration,
Best Regards,
DeNovoG
First of all, thanks for all the tools out there that makes our biological research and data analysis possible.
Today, I just wanted to lay a constructive critique about source code commenting.
Please be kind and thouroughly comment your source codes for software and scripts following the pragmatic and style rules suggested by your programming language. Especially tell us what your subroutines do and what are the variables for.
#
//
I believe that this practice will contribute with our community which shares many different programming languages and levels of understanding among users.
Thank you for your consideration,
Best Regards,
DeNovoG
Comment