Skip to content

Commit 815fca1

Browse files
committed
Submit RST file edits based on HTML rendering
1 parent d2fe244 commit 815fca1

File tree

5 files changed

+29
-27
lines changed

5 files changed

+29
-27
lines changed

README.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ In the upper right corner of the documentation's title bar, there is an option f
3333
viewing the documentation for the latest stable release to viewing the documentation for the
3434
development version or previously released versions.
3535

36-
On the `PyEDB-Core <https://github.com/ansys/pyedb-core/issues>`_ page, you can create
36+
On the `PyEDB-Core Issues <https://github.com/ansys/pyedb-core/issues>`_ page, you can create
3737
issues to report bugs and request new features. When possible, use these issue templates:
3838

3939
* Bug report template
@@ -53,5 +53,5 @@ License
5353
PyEDB-Core is licensed under the MIT license.
5454

5555
PyEDB-Core makes no commercial claim over Ansys whatsoever. The use of this Python client requires
56-
a legally licensed local copy of AEDT. For more information, see the
56+
a legally licensed copy of AEDT. For more information, see the
5757
`Ansys Electronics <https://www.ansys.com/products/electronics>`_ page on the Ansys website.

doc/source/contribute.rst

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ This package supports Python 3.9 through 3.12 on Windows, Linux, and MacOS.
4242
# Activate it in a Windows Powershell environment
4343
.venv\Scripts\Activate.ps1
4444
45-
#. Make sure you have the latest required build system and doc, testing, and CI tools:
45+
#. Make sure you have the latest required build system and documentation, testing, and CI tools:
4646

4747
.. code:: bash
4848
@@ -55,43 +55,43 @@ This package supports Python 3.9 through 3.12 on Windows, Linux, and MacOS.
5555
5656
#. Verify your development installation:
5757

58-
.. code:: bash
58+
.. code:: bash
5959
60-
tox
60+
tox
6161
6262
Testing
6363
-------
6464

65-
This project takes advantage of `tox`_. This tool allows you to automate common
66-
development tasks (similar to Makefile), but it is oriented towards Python
67-
development.
65+
This project takes advantage of `tox`_. Similar to Makefile, this tool allows you to automate
66+
common tasks, but it is oriented towards Python development.
6867

6968
Using ``tox``
7069
^^^^^^^^^^^^^
7170

72-
As Makefile has rules, `tox`_ has environments. In fact, the tool creates its
71+
While Makefile has rules, `tox` has environments. In fact, the tool creates its
7372
own virtual environment so anything being tested is isolated from the project
7473
to guarantee the project's integrity. The following environments commands are provided:
7574

7675
- **tox -e style**: Checks for coding style quality.
77-
- **tox -e test**: Checks for unit tests. Replace X with the minor version of your Python environment.
78-
Pass `pytest <pytest_>`_ flags after the ``--`` portion of the command. For example, use this
79-
``pytest`` command to show the standard output: ``tox -e py3X -- -s``.
76+
- **tox -e test**: Checks for unit tests. Pass `pytest <pytest_>`_ flags after the
77+
``--`` portion of the command. For example, use this ``pytest`` command to show the
78+
standard output, replacing ``X`` with the minor version of your Python environment:
79+
``tox -e py3X -- -s``.
8080
- **tox -e coverage**: Checks for code coverage.
81-
- **tox -e doc**: Checks for the documentation-building process.
81+
- **tox -e doc**: Checks for documentation building.
8282

8383
Raw testing
8484
^^^^^^^^^^^
8585

86-
If required, you can always call style commands, such as `black`_, `isort`_,
87-
and `flake8`_, or unit testing ones, such as `pytest`_ from the command line.
88-
However, this does not guarantee that your project is being tested in an isolated
89-
environment, which is the reason why tools like `tox`_ exist.
86+
If required, you can always call code style tools, such as `black`_, `isort`_,
87+
and `flake8`_, or unit testing tools, such as `pytest`_ from the command line.
88+
However, using these tools do not guarantee that your project is being tested in an isolated
89+
environment, which is the reason why a tool like `tox`_ exists.
9090

9191
Adhere to code style
9292
--------------------
9393
PyEDB-Core follows the PEP8 standard as indicated in `PEP 8 <dev_guide_pyansys_pep8_>`_
94-
in the *PyAnsys developer's guide* and implements style checking using `pre-commit <pre-commit_>`_.
94+
in the *PyAnsys developer's guide*. It also implements style checking using `pre-commit <pre-commit_>`_.
9595

9696
To ensure your code meets minimum code styling standards, run these commands:
9797

@@ -106,7 +106,7 @@ You can also install this as a pre-commit hook by running this command:
106106
107107
pre-commit install
108108
109-
This way, it's not possible for you to push code that fails the style checks:
109+
This way, it's not possible for you to push code that fails the code style checks:
110110

111111
.. code:: text
112112

doc/source/examples/index.rst

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ To run these notebooks, perform these steps:
66

77
#. Create and activate a Python `virtual environment <venv_>`_:
88

9-
.. code:: bash
9+
.. code:: bash
1010
11-
python -m venv .venv
12-
.venv\Scripts\activate.bat
11+
python -m venv .venv
12+
.venv\Scripts\activate.bat
1313
1414
For more information on creating and installing a virtual environment, see
1515
:ref:`dev_install`.
@@ -32,17 +32,17 @@ To run these notebooks, perform these steps:
3232
3333
python -m pip install .[notebook]
3434
35-
# Install the IPython kernel:
35+
#. Install the IPython kernel:
3636

3737
.. code:: bash
3838
3939
ipython kernel install --user --name=.venv
4040
4141
#. Launch Juptyer notebook:
4242

43-
.. code:: bash
43+
.. code:: bash
4444
45-
jupyter-notebook
45+
jupyter-notebook
4646
4747
6. Navigate to desired notebook example, change the kernel to the virtual environment, and execute the notebook
4848
with the desired settings.

doc/source/getting_started/index.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ Installation
1919
2020
#. To install PyEDB-Core, run this command:
2121

22-
.. code:: bash
22+
.. code:: bash
2323
24-
python -m pip install ansys-edb
24+
python -m pip install ansys-edb
2525
2626
.. LINKS AND REFERENCES
2727
.. _pip: https://pypi.org/project/pip/

doc/styles/Vocab/ANSYS/accept.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,7 @@ pyedb
66
PyEDB-Core
77
EDB
88
IPython
9+
isort
910
Juptyer
1011
Makefile
12+
pytest

0 commit comments

Comments
 (0)