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

New tutorials section #1876

Open
wants to merge 35 commits into
base: master
Choose a base branch
from
Open

Conversation

luisaFelixSalles
Copy link
Contributor

@luisaFelixSalles luisaFelixSalles commented Nov 7, 2024

This PR add the tutorials section in the documentation

  • Change the user guide index page
  • Create the tutorials section/ topics
  • Add the jupyter_sphinx extension so the tutorials snippets will be executed when the doc is built

Preview on how it renders:

_D__ANSYSdev_pydpf-core_doc_build_html_user_guide_index html

@luisaFelixSalles luisaFelixSalles added the documentation Improvements or additions to documentation label Nov 7, 2024
@luisaFelixSalles luisaFelixSalles self-assigned this Nov 7, 2024
Copy link

codecov bot commented Nov 7, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.48%. Comparing base (3883355) to head (293a63d).

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1876      +/-   ##
==========================================
+ Coverage   88.42%   88.48%   +0.06%     
==========================================
  Files          89       89              
  Lines       10251    10251              
==========================================
+ Hits         9064     9071       +7     
+ Misses       1187     1180       -7     

@luisaFelixSalles luisaFelixSalles mentioned this pull request Nov 8, 2024
15 tasks
@PProfizi PProfizi added the tutorials Related to PyDPF-Core tutorials label Nov 19, 2024
luisaFelixSalles and others added 11 commits December 19, 2024 15:01
* add a file with refs and links to be used in the doc

* add a file with refs and links to be used in the doc
* add animate_data.rst tutorial

* completes the animate_data.rst tutorial

* Apply suggestions from code review

Co-authored-by: Paul Profizi <[email protected]>

* codes for just one case and erase badges

* change tutorial name

* last updates

* Update animate_time.rst

* Fixing moving camera

* Apply suggestions from code review

Co-authored-by: Luisa Felix Salles <[email protected]>

* Update doc/source/user_guide/tutorials/animate/animate_time.rst

* Apply suggestions from code review

Co-authored-by: JennaPaikowsky <[email protected]>

* Apply suggestions from code review

Co-authored-by: Luisa Felix Salles <[email protected]>

* Apply suggestions from code review

* Update doc/source/user_guide/tutorials/animate/animate_time.rst

* updates

---------

Co-authored-by: Paul Profizi <[email protected]>
Co-authored-by: PProfizi <[email protected]>
Co-authored-by: JennaPaikowsky <[email protected]>
@luisaFelixSalles luisaFelixSalles force-pushed the doc/new-tutorials-section branch from 576cd9f to 627c2de Compare December 19, 2024 16:42
luisaFelixSalles and others added 2 commits January 8, 2025 17:28
* add new basic tutorial and jupyter_ sphinx extension

* separate the documentation part from the contributing.rst (main page)

* create the index page for the writing documentation section

* add the tutorials guide lines file

* add the tutorial template file

* updates the contributing.rst main page

* add a separate section for develop code (contributing)

* add the writing documentation index page

* add new links to links_and_refs.rst

* add tutorial_card_template.rst

* add tutorial_section_template.rst

* add toctree to index file of the write_doc folder

* add first part of the guide_lines_tutorials.rst

* updates

* final first version of guide_lines_tutorials.rst

* add tutorial_content_template.rst

* add tutorial_structure_template.rst

* updates the guide_lines_tutorials.rst with the new tutorial templates refs

* updates the guide_lines_tutorials.rst

* delete file basic_tutorial.rst

* Update doc/source/getting_started/write_doc/guide_lines_tutorials.rst

* Update doc/source/getting_started/write_doc/tutorial_structure_template.rst

* Apply suggestions from code review

Co-authored-by: Paul Profizi <[email protected]>

* updates the links references in the rst files

* updates the links references in the install.rst file

* redirect to the PyAnsys guidelines for developing code and add the installation explanation before cloning

* redirect to the PyAnsys guidelines for developing documentation

* add new links and substitution text to the links_and_refs.rst file

* update text in index.rst (write doc)

* update the guide_lines_tutorials.rst

* update the tutorial_structure_template.rst

* add the installing dpf server explanation to the write code index.rst

* add the link to the jupyter execute extension doc to the links_and_refs.rst file

* rename the guidelines_tutorials.rst file

* updates the guidelines_tutorials.rst name in the toctree of the write doc index.rst

* Apply suggestions from code review

Co-authored-by: Paul Profizi <[email protected]>

* Apply suggestions from code review

Co-authored-by: Paul Profizi <[email protected]>

* Apply suggestions from code review

Co-authored-by: Paul Profizi <[email protected]>

* Update doc/source/getting_started/write_doc/guidelines_tutorials.rst

Co-authored-by: Paul Profizi <[email protected]>

* Apply suggestions from code review

Co-authored-by: Paul Profizi <[email protected]>

* updates the index.rst of the write doc section

* add a new link to the links_and_refs.rst file

---------

Co-authored-by: Paul Profizi <[email protected]>
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 tutorials Related to PyDPF-Core tutorials
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants