CONTRIBUTING: make clear that --accept works for all golden tests...

not just docx.
This commit is contained in:
John MacFarlane 2019-07-19 09:29:10 -07:00
parent d4b2128d55
commit 72ddbf5994

View file

@ -188,12 +188,14 @@ under the `test/Tests` hierarchy corresponding to the pandoc module you
are changing. Alternatively, you may add a "command test" to are changing. Alternatively, you may add a "command test" to
the `/test/command/` hierarchy, following the pattern of the tests there. the `/test/command/` hierarchy, following the pattern of the tests there.
For `docx` tests, you can rebuild the golden tests by passing `--accept` You can rebuild the golden tests in `tests/` by passing
to the test script (so if you're using stack, `--accept` to the test script. (If you're using stack, `stack
`stack test --test-arguments "-p Docx --accept"`. Then just make sure to test --test-arguments "--accept"`; or `make TESTARGS=--accept`).
commit the changed golden files in their own commit with a line that you Then check the changed golden files for accuracy, and
checked them in Word (mentioning Word version and OS), that they weren't commit the changes. For docx or pptx tests, open the files in Word
corrupted, and that they had the expected output. or Powerpoint to ensure that they weren't corrupted and that
they had the expected result, and mention the Word/Powerpoint
version and OS in your commit comment.
Benchmarks Benchmarks
---------- ----------