cva6/CONTRIBUTING.md
2018-07-02 16:05:48 -07:00

2.1 KiB

Styleguides

See style-guidlines

Git Considerations

  • Do not push to master, if you want to add a feature do it in your branch.
  • Separate subject from body with a blank line.
  • Limit the subject line to 50 characters.
  • Capitalize the subject line.
  • Do not end the subject line with a period.
  • Use the imperative mood in the subject line.
  • Use the present tense ("Add feature" not "Added feature").
  • Wrap the body at 72 characters.
  • Use the body to explain what and why vs. how.
  • Consider starting the commit message with an applicable emoji:
    • :sparkles: When introducing a new feature
    • 🎨 :art: Improving the format/structure of the code
    • :zap: When improving performance
    • 🔥 :fire Removing code or files.
    • 📝 :memo: When writing docs
    • 🐛 :bug: When fixing a bug
    • 🗑️ :wastebasket: When removing code or files
    • 💚 :green_heart: When fixing the CI build
    • 👷 :construction_worker: Adding CI build system
    • :white_check_mark: When adding tests
    • 🔒 :lock: When dealing with security
    • ⬆️ :arrow_up: When upgrading dependencies
    • ⬇️ :arrow_down: When downgrading dependencies
    • 🚨 :rotating_light: When removing linter warnings
    • ✏️ :pencil2: Fixing typos
    • ♻️ :recycle: Refactoring code.
    • 💥 :boom: Introducing breaking changes
    • 🚚 :truck: Moving or renaming files.
    • 👾 :space_invader: When fixing something synthesis related
    • 🍻 :beer: Writing code drunkenly.
    • 👌 :ok_hand Updating code due to code review changes
    • 🏗️ :building_construction: Making architectural changes.
    • 🔧 :wrench: Tooling
    • 🚧 :construction: Work In Progress WIP
    • 🔖 :bookmark: version tag

If you use vi for your commit message, consider to put the following snippet inside your ~/.vimrc:

autocmd Filetype gitcommit setlocal spell textwidth=72s