In computer science, one of the most critical writing skills is the ability to convey your ideas and vision to another person. Countless amounts of time are spent as developers try to convey their code design in words to someone else. They may be another member of the team you're working with or a person from outside of the organization. In either case, it is important to be able to effectively convey yourself to others. For instance, you may have to explain the complexities of your code to another teammate who will be working with it. In this regard, it helps to properly document your code in a manner that is easy to follow, clear and concise.
A way to help learn this skill is to take a large system or process, and break it down into its smaller pieces. Then try to write out each piece's purpose, a brief description of how that piece works, and how it fits into the overall process. When code is properly documented, clearly and concisely, it becomes much easier for another person to understand quickly how the software works. Another good way to become more adept at this is to take a systems analysis or documentation course at a university or technical college.
No comments:
Post a Comment