Skip to content

Latest commit

 

History

History
53 lines (30 loc) · 2.77 KB

writing-readable-code.md

File metadata and controls

53 lines (30 loc) · 2.77 KB

Writing Readable Code

Prerequisite

Attendance at Techtonica's HTML/CSS & JS workshops

Motivation

  • Since most software engineering is done in teams, it's important that the code you write is easy for others to read. You will be expected to write easily-readable code as a software engineer.
  • Readable code is beneficial to everyone. Sometimes you may have to return to a code you wrote some time ago or perhaps another engineer might have to make updates to your code. You save a considerable amount of time by writing code that will be easy to read and understand.

Looking at an example

  • Professional engineers tend to write readable code more often than not. An example is css-tricks, a popular site that teaches various skills relating to Front-end development. There are various code snippets available on the site and these code snippets are written in a manner that makes then easily readable. For example, this page on HTML form markups which makes it easy to understand the role of various elements being used.

Objectives

Participants will be able to:

  • Refactor a provided code sample to make it more readable

Specific Things to Learn

  • Legibility
  • Writing descriptive, semantic variable and function names
  • Using whitespace
  • Using local variables well

Lesson

Common Mistakes / Misconceptions

-"As long as my code does what it's supposed to do, it's good enough." Functionality is very important, but it's only part of the bigger picture. Being able to easily maintain your code is important, too.

Independent Practice

  1. Using REPL.it write a function called findMax that takes in 3 integers as parameters and returns the largest of the 3 integers.

  2. Using REPL.it write a function called bigWord that takes in a word as a string and returns True if the word has at least 10 letters and False if the word has 9 or fewer letters.

Supplemental Materials

Check for Understanding

  • Why is it important to write readable code?
  • How do you make your code more readable?
  • If you want to assign your Birth Year to a variable which variable name would be more appropriate: let x or let myBirthYear.