Skip to content

Latest commit

 

History

History
69 lines (50 loc) · 3.8 KB

CONTRIBUTING.md

File metadata and controls

69 lines (50 loc) · 3.8 KB
Raw

Thank you for taking an interest in contributing to chain-bench !

Contributing, bug reporting, openning issues and starting discussions

Issues

  • Feel free to open an issue for any reason as long as you make it clear if the issue is about a bug/feature/question/comment.
  • Please spend some time giving due diligence to the issue tracker. Your issue might be a duplicate. If it is, please add your comment to the existing issue.
  • Remember, users might be searching for your issue in the future. So please give it a meaningful title to help others.
  • The issue should clearly explain the reason for opening the proposal if you have any, along with any relevant technical information.
  • For questions and bug reports, please include the following information:
    • version of chain-bench you are running (from chain-bench version) along with the command line options you are using.

Bugs

If you think you have found a bug please follow the instructions below.

  • Open a new bug if a duplicate doesn't already exist.
  • Make sure to give as much information as possible in the following questions
    • Overview
    • How did you run chain-bench?
    • What happened?
    • What did you expect to happen
    • Environment
    • Running processes
    • Configuration files
    • Anything else you would like to add

Features

We also use the GitHub discussions to track feature requests. If you have an idea to make chain-bench even more awesome follow the steps below.

  • Open a new discussion if a duplicate doesn't already exist.
  • Remember users might be searching for your discussion in the future, so please give it a meaningful title to helps others.
  • Clearly define the use case, using concrete examples. For example, I type this and chain-bench does that.
  • If you would like to include a technical design for your feature please feel free to do so.

Questions

We also use the GitHub discussions to Q&A.

  • Open a new discussion if a duplicate doesn't already exist.
  • Remember users might be searching for your discussion in the future, so please give it a meaningful title to helps others.

Pull Requests

We welcome pull requests!

  • Every Pull Request should have an associated Issue, unless you are fixing a trivial documentation issue.
  • We will not accept changes to LICENSE, NOTICE or CONTRIBUTING from outside the Argon Security team. Please raise an Issue if you believe there is a problem with any of these files.
  • Your PR is more likely to be accepted if it focuses on just one change.
  • Describe what the PR does. There's no convention enforced, but please try to be concise and descriptive. Treat the PR description as a commit message. Titles that start with "fix"/"add"/"improve"/"remove" are good examples.
  • Please add the associated Issue in the PR description.
  • Please include a comment with the results before and after your change.
  • There's no need to add or tag reviewers.
  • If a reviewer commented on your code or asked for changes, please remember to mark the discussion as resolved after you address it. PRs with unresolved issues should not be merged (even if the comment is unclear or requires no action from your side).
  • Please include a comment with the results before and after your change.
  • Your PR is more likely to be accepted if it includes tests (We have not historically been very strict about tests, but we would like to improve this!).
  • You're welcome to submit a draft PR if you would like early feedback on an idea or an approach.
  • Happy coding!

Documentation

You can build the documents as below and view it at http://localhost:8000.

make mkdocs-serve