Hi Gurkan, do you have examples? Personally I'm not a big fan of this kind of comments https://github.com/apache/openwebbeans/blob/91dcbf2484c7da9aeba9a90712a4a16f8438c84f/webbeans-impl/src/main/java/org/apache/webbeans/component/OwbBean.java#L100 It fully paraphrases the method and increase the understanding cost since it makes 5 lines equivalent to 1 already explicit line. However, if there are some algorithms which are unclear, we should obviously clarify them but AFAIK our code is quite explicit but happy to fix anything not obvious if you can point out the parts you don't get.
Romain Manni-Bucau @rmannibucau <https://twitter.com/rmannibucau> | Blog <https://rmannibucau.metawerx.net/> | Old Blog <http://rmannibucau.wordpress.com> | Github <https://github.com/rmannibucau> | LinkedIn <https://www.linkedin.com/in/rmannibucau> | Book <https://www.packtpub.com/application-development/java-ee-8-high-performance> Le ven. 5 juin 2020 à 10:48, Gurkan Erdogdu <cgurkanerdo...@gmail.com> a écrit : > Hi folks > I am reviewing the source code, but there are codes without comments in > many places. Please can you review the codes and write comments?I know this > is boring, but commenting is very important. Otherwise, it is not possible > to understand what is going on in your code. > Regards. > Gurkan >
