prezto/CONTRIBUTING.md
2017-04-15 01:36:15 -07:00

2 KiB

Contributing

This project would not exist without all of its users and contributors.

If you have ideas on how to make the configuration easier to maintain or improve its performance, do not hesitate to fork and send pull requests.

Issue Reporting

  • Check that the issue has not already been reported.
  • Check that the issue has not already been fixed in the latest code.
  • Open an issue with a clear title and description in grammatically correct, complete sentences.

Pull Request

Code Style

  • Indent using 2 spaces. No tabs.
  • Put ; do and ; then on the same line as the while, for or if.
  • Local variables should be used whenever possible.
  • Use snake_case for variable and function naming.
  • Local variables should be lower cased.
  • Global variables should be upper cased.
  • Use $(command) instead of backticks.
  • Avoid eval if possible.
  • Prefer zstyle over environment variables for configuration.

Modules

  • A README.md must be present.
  • Large functions must be placed in a functions directory.
  • Functions that take arguments must have completion.

Themes

  • A screenshots section must be present in the file header.
  • The pull request description must have embedded screenshots.