Posts

Showing posts with the label readability

Coding best practices - Part 2

Image
Coding best practices Published Version: 1.0 To check the 1st part click the below link; Coding best practices - Part 1 Avoid Obvious Comments Commenting your code is fantastic; however, it can be overdone or just be plain redundant . Take this example: Fig 1: Incorrect example with Avoid Obvious Comments When the text is that obvious , it's really not productive to repeat it within comments. If you must comment on that code, you can simply combine it to a single line instead: Fig 2: Correct example with Avoid Obvious Comments Note: If you have to write more than a one-line comment to explain what the code is doing, you should consider rewriting the code to be more readable.

Coding best practices - Part 1

Image
Coding best practices Published Version: 1.0 What Does Coding Really Mean? The definition of " coding " means inputting commands in a language that computers can understand, to build websites, apps and software. Computer coding is the process of using a programming language to deliver instructions to a computer. The code tells the machine what tasks to perform and how to perform them. These detailed instructions are written in multiple lines of code, and a document full of code is called a script . The script directs the computer to carry out your desired actions. You have to ensure your code is correct, simple, clean and readable.  Purpose of Having Coding Standards Maintaining the coding standards is the best practices at the time of coding as because of; A coding standard gives a uniform appearance to the codes written by different engineers . It improves readability, and maintainability of the code and it reduces complexity also. It helps in code reuse and helps to de...