Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation issues/enhancements #560

Open
klmcadams opened this issue Jan 13, 2024 · 2 comments
Open

Documentation issues/enhancements #560

klmcadams opened this issue Jan 13, 2024 · 2 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@klmcadams
Copy link
Collaborator

klmcadams commented Jan 13, 2024

Description of the modifications

These are issues and enhancements that could make this page of the docs better: https://mechanical.docs.pyansys.com/version/stable/

Issues

  • The PyAnsys link is broken
  • Remove "Project Index" and bullet point at the end
  • The PyMechanical Documentation link points to itself (circular link)

Enhancements (just ideas - up to discussion)

  • Explain how pymechanical is different than using Mechanical - this is kind of done in the Introduction section
  • Include a diagram or two to show how things work?
  • Add setup or installation information for pymechanical towards the top of the page
  • Add a small usage example on the page
    • we can then say for more examples, see the Examples link

I think it would be beneficial to combine the landing page with the "Getting Started" tab in the docs. That way, when people visit our site they have everything they need in front of them to get started, and from that base information, we can link supplementary help & info that can be accessed in the other tabs

Useful links and references

https://mechanical.docs.pyansys.com/version/stable/

Include this youtube video as a brief tutorial: https://youtu.be/a72Wxj-xL4Q?feature=shared&t=314

@klmcadams klmcadams added the documentation Improvements or additions to documentation label Jan 13, 2024
@klmcadams klmcadams self-assigned this Jan 13, 2024
@dipinknair dipinknair assigned dipinknair and unassigned dipinknair Jan 13, 2024
@pmaroneh
Copy link
Collaborator

Hi @klmcadams , I believe these are good suggestions. In terms of additional explanation and adding diagrams, I find that these two are helfpul with customer interactions:

  • difference between in-product and PyAnsys scripting:
    image
  • difference between embedded and remote PyMechanical:
    image
    If you think these might help, I'm happy to share the editable version of these pics with you.

@klmcadams
Copy link
Collaborator Author

@pmaroneh Sure, those would be great! Thanks!

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
Projects
None yet
Development

No branches or pull requests

3 participants