From 7217359af195bfc75f4b8ffb99070c3c8bd40e59 Mon Sep 17 00:00:00 2001 From: Kamran Ahmed Date: Mon, 23 Jan 2023 03:27:04 +0400 Subject: [PATCH] Update src/roadmaps/software-design-architecture/content/100-clean-code-principles/111-use-meaningful-names.md --- .../111-use-meaningful-names.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/src/roadmaps/software-design-architecture/content/100-clean-code-principles/111-use-meaningful-names.md b/src/roadmaps/software-design-architecture/content/100-clean-code-principles/111-use-meaningful-names.md index 40410f760..54b1dd81e 100644 --- a/src/roadmaps/software-design-architecture/content/100-clean-code-principles/111-use-meaningful-names.md +++ b/src/roadmaps/software-design-architecture/content/100-clean-code-principles/111-use-meaningful-names.md @@ -1,17 +1,16 @@ # Use Meaningful Names -Using meaningful names in system architecture is important for making the code clear, readable, and easy to understand. Meaningful names can help to convey the intent and function of variables, functions, classes, and other elements of the code. +Using meaningful names is important for making the code clear, readable, and easy to understand. Meaningful names can help to convey the intent and function of variables, functions, classes, and other elements of the code. Here are some ways to use meaningful names in system architecture: -1. Use descriptive and meaningful names for variables, functions, classes, and other elements of the code. -2. Use consistent naming conventions throughout the codebase, such as camelCase for variables and PascalCase for functions and classes. -3. Use abbreviations and acronyms sparingly and only if they are widely understood. -4. Use meaningful prefixes or suffixes to indicate the type or purpose of a variable or function, such as "is" or "get" for boolean variables or "list" for array variables -5. Avoid using single letter variable names or generic names, such as "temp" or "x" that do not convey any meaning. -6. Avoid using overly long or complex names that make the code harder to read. +- Use descriptive and meaningful names for variables, functions, classes, and other elements of the code. +- Use consistent naming conventions throughout the codebase, such as camelCase for variables and PascalCase for functions and classes. +- Use abbreviations and acronyms sparingly and only if they are widely understood. +- Use meaningful prefixes or suffixes to indicate the type or purpose of a variable or function, such as "is" or "get" for boolean variables or "list" for array variables +- Avoid using single letter variable names or generic names, such as "temp" or "x" that do not convey any meaning. +- Avoid using overly long or complex names that make the code harder to read. -By following these best practices, the system architecture will be more maintainable, testable, and less error-prone, and it will be easier to read and understand the code. Learn more from the following links: