diff --git a/spec-0013/index.md b/spec-0013/index.md index c3863dbb..1bca00a2 100644 --- a/spec-0013/index.md +++ b/spec-0013/index.md @@ -12,16 +12,24 @@ endorsed-by: ## Description -For consistency and decreased cognitive load across the ecosystem, this SPEC recommends naming conventions around various project aspects--such as project structure, repository layout, folder names, task runner and `pyproject.toml` targets name. +For consistency and decreased cognitive load across the ecosystem, this SPEC +recommends naming conventions around various project aspects--such as project +structure, repository layout, folder names, task runner and `pyproject.toml` +targets name. -From a cursory survey in the Scientific Python ecosystem, we discover some frustration from contributors and maintainer when moving from one project to another and belive that consistency will make it both easier for existing maintainer to contribute to project as well a decrease the confusion of new developers when contributing or creating new projects. +From a cursory survey in the Scientific Python ecosystem, we discover some +frustration from contributors and maintainer when moving from one project to +another and believe that consistency will make it both easier for existing +maintainer to contribute to project as well a decrease the confusion of new +developers when contributing or creating new projects. ## Implementation -We recommend that by default the targets and folder names: - - related to testing be named `tests` (and not `test`) - - related to documentation be named `docs` (and not `doc`) - - both should be lowercase. +We recommend that by default the targets and folder names: + +- related to testing be named `tests` (and not `test`) +- related to documentation be named `docs` (and not `doc`) +- both should be lowercase. It is ok to have the singular aliases, but the plurals should always be the default. @@ -29,7 +37,7 @@ It is ok to have the singular aliases, but the plurals should always be the defa pyproj.toml docs folder -pip install .[] +pip install .[] spin and dev.py tox