Skip to content

Commit

Permalink
Add vale documentation check (#302)
Browse files Browse the repository at this point in the history
* Add pyansys doc checking

* Add vocab and file ignores

* Additional corrections

* Update .github/workflows/ci_cd.yml
  • Loading branch information
Andy-Grigg authored Dec 30, 2022
1 parent ec96dce commit 5e56553
Show file tree
Hide file tree
Showing 5 changed files with 23 additions and 3 deletions.
11 changes: 10 additions & 1 deletion .github/workflows/ci_cd.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,16 @@ jobs:
- name: Lint project
run: |
tox -e lint
docs-style:
name: Documentation Style Check
runs-on: ubuntu-latest
steps:
- name: PyAnsys documentation style checks
uses: pyansys/actions/doc-style@v2
with:
token: ${{ secrets.GITHUB_TOKEN }}

test:
name: Unit test on supported platforms
runs-on: ubuntu-latest
Expand Down
2 changes: 1 addition & 1 deletion doc/source/_static/README.md
Original file line number Diff line number Diff line change
@@ -1 +1 @@
You will find static files (like images and other assets) here.
Find static files (like images and other assets) here.
4 changes: 4 additions & 0 deletions doc/source/_templates/custom-class-template.rst
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
.. vale off
{{ fullname | escape | underline}}

.. currentmodule:: {{ module }}
Expand Down Expand Up @@ -32,3 +34,5 @@
{%- endfor %}
{% endif %}
{% endblock %}

.. vale on
4 changes: 4 additions & 0 deletions doc/source/_templates/custom-module-template.rst
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
.. vale off
{{ fullname | escape | underline}}

.. automodule:: {{ fullname }}
Expand Down Expand Up @@ -64,3 +66,5 @@
{%- endfor %}
{% endif %}
{% endblock %}

.. vale on
5 changes: 4 additions & 1 deletion doc/styles/Vocab/ANSYS/accept.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,7 @@ ANSYS
Ansys
ansys
OpenAPI
OpenAPI-Common
OpenAPI-Common
Kerberos
Heimdal
APIs

0 comments on commit 5e56553

Please sign in to comment.