Skip to content

docs: Getting Started & ecosystem links#1655

Merged
dipinknair merged 9 commits into
mainfrom
docs/improve_getting_started
Jun 12, 2026
Merged

docs: Getting Started & ecosystem links#1655
dipinknair merged 9 commits into
mainfrom
docs/improve_getting_started

Conversation

@jgd10

@jgd10 jgd10 commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

I am currently working on reviewing and improving PyAnsys Getting Started sections and this work is part of that. It is reasonable to assume new users of PyMechanical will be familiar with Python and pip but not guaranteed. So I have added a note + link that makes it clearer what those items are for people that don't know when they first get mentioned in the docs.

In addition, I have added a section on the Ansys wider developer ecosystem to the troubleshooting section including a set of links to places where users can expect to find resources that may be of assistance, such as the portal, forum AIS, ALH, etc.

I have not been able to fully build the docs with the changes locally because I do not have Mechanical installed, however, the changes are sufficiently small that a code review should suffice.

Changes

  • added note about pip and python packaging to install instructions
  • added dev ecosystem links section to troubleshooting page

Type of change

  • Bug fix
  • New feature
  • Documentation
  • Maintenance / refactor

Checklist

  • Title follows Conventional Commits (e.g. feat: add modal analysis support)
  • Tests added or updated
  • Documentation updated

I am currently working on reviewing and improving PyAnsys Getting
Started sections and this work is part of that. It is reasonable
to assume new users of PyMechanical will be familiar with Python and pip
but not guaranteed. So I have added a note + link that makes it clearer
what those items are for people that don't know when they first get
mentioned in the docs.

In addition, I have added a section on the Ansys wider developer
ecosystem to the troubleshooting section including a set of links to
places where users can expect to find resources that may be of
assistance, such as the portal, forum AIS, ALH, etc.

I have not been able to fully build the docs with the changes locally
because I do not have Mechanical installed, however, the changes are
sufficiently small that a code review should suffice.
@jgd10 jgd10 requested a review from a team as a code owner June 12, 2026 12:49
@jgd10 jgd10 self-assigned this Jun 12, 2026
@jgd10 jgd10 added the documentation Improvements or additions to documentation label Jun 12, 2026
@codacy-production

codacy-production Bot commented Jun 12, 2026

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@codecov

codecov Bot commented Jun 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.69%. Comparing base (ecbac14) to head (f09821f).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1655   +/-   ##
=======================================
  Coverage   80.69%   80.69%           
=======================================
  Files          43       43           
  Lines        3321     3321           
=======================================
  Hits         2680     2680           
  Misses        641      641           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@dipinknair dipinknair added the skip-test Skips the test job in CI label Jun 12, 2026
Comment thread doc/source/getting_started/installation.rst Outdated
Comment thread doc/source/getting_started/installation.rst
Comment thread doc/source/getting_started/troubleshooting.rst Outdated
Comment thread doc/source/getting_started/troubleshooting.rst Outdated
jgd10 and others added 4 commits June 12, 2026 14:35
Co-authored-by: Dipin <26918585+dipinknair@users.noreply.github.com>
Co-authored-by: Dipin <26918585+dipinknair@users.noreply.github.com>
Co-authored-by: Dipin <26918585+dipinknair@users.noreply.github.com>
Co-authored-by: Dipin <26918585+dipinknair@users.noreply.github.com>
Comment thread doc/source/getting_started/installation.rst Outdated
Co-authored-by: Dipin <26918585+dipinknair@users.noreply.github.com>
@jgd10

jgd10 commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

all suggestions applied!

@dipinknair

Copy link
Copy Markdown
Contributor

@jgd10 Thanks James for the contribution !

@dipinknair dipinknair merged commit d764308 into main Jun 12, 2026
42 checks passed
@dipinknair dipinknair deleted the docs/improve_getting_started branch June 12, 2026 14:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation skip-test Skips the test job in CI

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants