]> git.madduck.net Git - etc/vim.git/blobdiff - CONTRIBUTING.md

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

Move test/folding.md to test/folding.vader
[etc/vim.git] / CONTRIBUTING.md
index 7a603db37fee283d38461892640cebab5c8f0880..a2c158087b5759bcdb1c039aa4b4d953676c08ca 100644 (file)
@@ -36,12 +36,19 @@ If you wish to have a behavior that differs from that style guide, add an option
 
 # Tests
 
-All new features must have tests. We don't require unit tests: tests that require users to open markdown code in Vim and check things manually are accepted, but you should point clearly to where the tests are.
+All new features must have unit tests.
 
-Wherever possible, use test cases from the [karlcow's Markdown Test Suite](https://github.com/karlcow/markdown-testsuite), and link to the relevant test files on your merge request.
+# Issues
 
-If a test does not exist there yet, make a pull request to them, and link to that pull request on the pull request you make here.
+Issues are tracked within GitHub.
 
-If the test you want to do is not appropriate for the Markdown Test Suite, create it only under the `test/` directory here.
+When reporting issues, your report is more effective if you include a minimal example file that reproduces the problem. Try to trim out as much as possible, until you have the smallest possible file that still reproduces the issue. Paste the example inline into your issue report, quoted using four spaces at the beginning of each line, like this example from issue [#189](https://github.com/plasticboy/vim-markdown/issues/189):
 
-If we start disagreeing too often on what is appropriate or not, we will fork off that repository.
+```
+Minimal example:
+
+    ```
+    =
+    ```
+    bad!
+```