update README.md

python/code_quality/black/README.md

@@ -21,10 +21,13 @@ line-length = 100
 
 ## How to use it
 
-2. Include template in your CI/CD conf (see quick use above)
-3. Customize the template if it's relevant
+1. Configure the black section of `pyproject.toml` in your repository's with your desired rules.
+2. Include the Black template in your CI/CD configuration (see quick use above).
+3. Customize the template if it's relevant.
 
-## Add <a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a> cartouche to your project README.md
+## Add a <a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a> badge to your project README.md
+
+To display the use of Black in your project, you can add the following badge to your README.md:
 
 ```markdown
 <a href="https://github.com/psf/black">

python/code_quality/flake8/README.md

@@ -19,8 +19,8 @@ max-complexity = 10
 max-line-length = 100
 ```
 
-This example ignores certain errors, sets the maximum line length to 100 characters, excludes the
-tests directory, and sets the maximum McCabe complexity to 10.
+This example sets the maximum line length to 100 characters, excludes the tests directory, and sets
+the maximum complexity to 10.
 
 ## How to use it