summaryrefslogtreecommitdiffstats
path: root/doc/internals/contributing.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-05 16:20:58 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-05 16:20:58 +0000
commit5bb0bb4be543fd5eca41673696a62ed80d493591 (patch)
treead2c464f140e86c7f178a6276d7ea4a93e3e6c92 /doc/internals/contributing.rst
parentAdding upstream version 7.2.6. (diff)
downloadsphinx-5bb0bb4be543fd5eca41673696a62ed80d493591.tar.xz
sphinx-5bb0bb4be543fd5eca41673696a62ed80d493591.zip
Adding upstream version 7.3.7.upstream/7.3.7
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'doc/internals/contributing.rst')
-rw-r--r--doc/internals/contributing.rst12
1 files changed, 10 insertions, 2 deletions
diff --git a/doc/internals/contributing.rst b/doc/internals/contributing.rst
index 195f6a5..207374e 100644
--- a/doc/internals/contributing.rst
+++ b/doc/internals/contributing.rst
@@ -114,7 +114,7 @@ These are the basic steps needed to start developing on Sphinx.
Write your code along with tests that shows that the bug was fixed or that
the feature works as expected.
-#. Add a bullet point to :file:`CHANGES` if the fix or feature is not trivial
+#. Add a bullet point to :file:`CHANGES.rst` if the fix or feature is not trivial
(small doc updates, typo fixes), then commit::
git commit -m '#42: Add useful new feature that does this.'
@@ -142,7 +142,7 @@ Please follow these guidelines when writing code for Sphinx:
* Try to use the same code style as used in the rest of the project.
-* For non-trivial changes, please update the :file:`CHANGES` file. If your
+* For non-trivial changes, please update the :file:`CHANGES.rst` file. If your
changes alter existing behavior, please document this.
* New features should be documented. Include examples and use cases where
@@ -197,6 +197,14 @@ To run JavaScript tests, use ``npm``::
npm install
npm run test
+.. tip::
+
+ ``karma`` requires a Firefox binary to use as a test browser.
+
+ For Unix-based systems, you can specify the path to the Firefox binary using::
+
+ FIREFOX_BIN="/Applications/Firefox.app/Contents/MacOS/firefox" npm test
+
New unit tests should be included in the ``tests`` directory where
necessary: