gitlab.com/Raven-IO/raven-delve@v1.22.4/CONTRIBUTING.md (about)

     1  # Contributing to Delve
     2  
     3  Want to help contribute to Delve? Great! Any and all help is certainly appreciated, whether it's code, documentation, or spelling corrections.
     4  
     5  If you are planning to contribute a significant change, please draft a design document (or start a conversation) and post it to the [developer mailing list](https://groups.google.com/forum/#!forum/delve-dev). This will allow other developers and users to discuss the proposed change.
     6  
     7  ## Filing issues
     8  
     9  When filing an issue, make sure to answer these six questions:
    10  
    11  1. What version of Delve are you using (`dlv version`)?
    12  2. What version of Go are you using? (`go version`)?
    13  3. What operating system and processor architecture are you using?
    14  4. What did you do?
    15  5. What did you expect to see?
    16  6. What did you see instead?
    17  
    18  ## Contributing code
    19  
    20  Fork this repo and create your own feature branch. Install all dependencies as documented in the README.
    21  
    22  ### Guidelines
    23  
    24  Consider the following guidelines when preparing to submit a patch:
    25  
    26  * Follow standard Go conventions (document any new exported types, funcs, etc.., ensuring proper punctuation).
    27  * Ensure that you test your code. Any patches sent in for new / fixed functionality must include tests in order to be merged into master.
    28  * If you plan on making any major changes, create an issue before sending a patch. This will allow for proper discussion beforehand.
    29  * Keep any os / arch specific code contained to os / arch specific files. Delve leverages Go's filename based conditional compilation, i.e do not put Linux specific functionality in a non Linux specific file.
    30  
    31  ### Format of the Commit Message
    32  
    33  We follow a rough convention for commit messages that is designed to answer two
    34  questions: what changed and why. The subject line should feature the what and
    35  the body of the commit should describe the why.
    36  
    37  ```
    38  terminal/command: Add 'list' command
    39  
    40  This change adds the 'list' command which will print either your current
    41  location, or the location that you specify using the Delve linespec.
    42  
    43  Fixes #38
    44  ```
    45  
    46  The format can be described more formally as follows:
    47  
    48  ```
    49  <subsystem>: <what changed>
    50  <BLANK LINE>
    51  <why this change was made>
    52  <BLANK LINE>
    53  <footer>
    54  ```
    55  
    56  The first line is the subject and should be no longer than 70 characters, the
    57  second line is always blank, and other lines should be wrapped at 80 characters.
    58  This allows the message to be easier to read on GitHub as well as in various
    59  git tools.
    60  
    61  ## Code of Conduct
    62  
    63  This project adopts the standard Go code of conduct: https://go.dev/conduct.