Discussion: Commenting for Clarity
As you have learned in the text, the process of compiling code changes it into a machine-readable (rather than user-readable) language your computer can then execute. The compiling process ignores any comments entered by the user, as they have no effect on the operation of the program. However, comments within code are valuable to you and any users who will read your code, arguably as important as the code itself.
Always comment your source code fully. You may be tempted to skip this step in the midst of coding because the program and all of its component classes, methods, and objects are fresh in your mind. When you move on to other projects, or return to a half-finished program later, those comments will be invaluable guides. Comments help you avoid much time and anguish trying to understand the code. The importance of commenting is even further underscored when you work with other programmers or when that code will eventually be maintained by someone else. Without thorough commenting, you have already made the job harder for future administrators of the program—before they have laid eyes on the code or even inspected a single method. Clients that cannot make sense of the code they paid for will be far less likely to seek you out for future programming jobs.
Review the sections of the text that refer to comments, including the three different methods you can use to code comments in Java. Next, go to any open source repository, where software developers collaborate on the development of open source software, and download the code from one or more open source projects. Some potential repositories to explore are: JavaWorld (https://www.javaworld.com/blog/open-source-java-projects/), and Java-Source (Open Source Software in Java).
Open Source Software in Java
You will notice that the quality of the programs and the quality of the programming varies greatly. Try to remember that these open source projects are posted by programmers of all different levels of experience, and the projects are in various stages of development. As such, they do not always embody sound programming practices.
Examine the source code for one or more open source projects and locate an example in which: (1) the documentation and commenting within the program leaves something to be desired and (2) more than one control flow statement is used. Inspect the code for the individual source files. If you are able to build the project, run the program a few times so you understand what the author of the program was trying to achieve and how the lines of code in the project work. Think about how the commenting could be improved.
BY DAY 3
Post a response that summarizes your findings. The post should:
Include a link to the open source project you chose as an example of poor commenting, or attach an example source file to your posting.
Identify the methods within the example program you believe are not sufficiently documented.
Examine the control flow statements to determine what they do and if their purpose is clearly documented.
Explain why you feel the current commenting within the project needs improvement.
Copy the example code into your post, replacing or adding detail to the current comments in order to make the program easier for a user to understand.
Model correspondence is a sort of nonverbal correspondence. Sort of nonverbal correspondence - According to eight significant nonverbal conduct, "the vast majority of our correspondence is nonverbal" (brain science, creator Kendra Cherry). Nonverbal correspondence incorporates non-verbal communication, hand development, head development, evasion of eye to eye connection, and pressure. Forcefully, nonverbal correspondence is deciphered similarly from culture to culture. Most types of nonverbal correspondence are past grins, embraces, and most hand developments. Exhibition correspondence is a path for us to impart in sentences and discussions. This incorporates body development, stance, signal, and eye to eye connection. My voice is a case of correspondence. There are different dialects in the world and you can convey through articulations and motions regardless of whether you can not comprehend what this individual says. - According to Quintanilla (2014), "... Since numerous nonverbal signals are oblivious or oblivious, consistently focus on nonverbal correspondence and that various motions have various implications for individuals You should comprehend "on page 26) The manner in which individuals and individuals see others might be because of their nonverbal correspondence. Individuals may have great substance about their data, however they may convey themselves such that they can not contact any other person. Non-verbal correspondence Any connection includes two primary components of how individuals are seen: words, or articulations and non-verbal words, articulations, signals, language sound, and other Position. Numerous individuals imagine that the primary messages are their words, yet that is really their nonverbal hints. The theory of this exploration paper is that outward appearances straightforwardly influence human discernment. This speculation is affirmed by short writing search. Nonverbal correspondence is normally more significant than verbal correspondence Nonverbal correspondence is inane than verbal correspondence Nonverbal correspondence is regularly more questionable than verbal correspondence. Non-verbal data about our own introduction, apparel style, and our character will be sent in situations, for example, residences, condos, vehicles or workplaces. Investigate some non verbal signs sent by your own introduction or condition. How would they say what your identity is? Do they make the impression you want? What is nonverbal correspondence? Nonverbal correspondence is all messages sent notwithstanding correspondence words. These messages are, for instance, discourse, face message, eye to eye connection, spatial message, and so forth. Nonverbal correspondence ordinarily passes on more importance than verbal correspondence. As per Dr. Albert Melavian, nonverbal correspondence represents 93% of every day correspondence. This measurement shows that nonverbal correspondence is significant in our every day life. At the point when we talk, we for the most part don't simply express in words, messages other than words pass on more data than words. Consequently, we can close both head and nonverbal work in return. The accompanying papers depict the significance of example based nonverbal correspondence and the sorts of nonverbal correspondence. Excellent correspondence incorporates non-verbal/non-composing correspondence perspectives. Speak with praiseworthy dialects through non-verbal communication, pitch, articulation and motions. At the point when we speak with one another, we regularly don't have the foggiest idea how our bodies are extended to other people. Our nerves can give a valiant effort, our disposition can dispense with an awful state of mind, we can let others show us boundless. - Exemplary correspondence includes nonverbal or composed prompts, for example, outward appearance, sound, or non-verbal communication. By underlining or truly thinking what is being advised, you can supplement verbal correspondence. At the point when a sales rep is flawless and looks benevolent, he can be viewed as solid and dependable. Individuals who are grimy and messy are frequently viewed as deceitful and dishonest. Exhibit correspondence is an approach to pass on nonverbal signals. Instances of nonverbal pieces of information incorporate inflection, outward appearance, and non-verbal communication. Excellent correspondence is the utilization of signals. Known as non verbal correspondence, it handles the sending and getting of messages. Exhibit correspondence can be arranged by human non-verbal communication, composed language, and nonverbal correspondence These correspondence can try perception turning into a catchphrase of correspondence. Part correspondence>GET ANSWER