镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content

Closes #173: Add Python Guidelines - #177

Draft
joeriddles wants to merge 1 commit into
mainfrom
python-guidelines
Draft

joeriddles wants to merge 1 commit into
mainfrom
python-guidelines

Conversation

@joeriddles

Copy link
Copy Markdown
Contributor

Work in progress.

@joeriddles

joeriddles commented May 7, 2021 •

Copy link
Copy Markdown
Contributor Author

@joeriddles

joeriddles commented Jun 16, 2021 •

Copy link
Copy Markdown
Contributor Author

Notes from Coding Standard review 6/16/21

Categories of standards:

  • Stylistic
  • Related to performance

Philosophy of coding guidelines (Kelly)

  1. Readability <-- lowers conceptual load, especially moving between projects/languages
  2. Uniformity / predictability <-- " "
  3. Pit of success <-- "If you always do it this way, you'll avoid a lot of issues"
  • "Why", not just "what" (Kevin)

How opinionated do we get?

  • AVOID vs. DO NOT (Mark)
  • "We are not going to take a stance on this ___"
    • We don't need to take an opinion on this
    • When do we need to be firm on something that's stylistic vs. not

CONSIDER: use when there's an exception
DO: when there's not an exception

@joeriddles

Copy link
Copy Markdown
Contributor Author

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant