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

Change source links to github #4113

Merged
merged 2 commits into from
Mar 10, 2023
Merged

Change source links to github #4113

merged 2 commits into from
Mar 10, 2023

Conversation

akaszynski
Copy link
Member

The mne libray uses sphinx.ext.linkcode rather than sphinx.ext.viewcode and they link directly to github:
mne.io.read_raw

This PR implements the same logic and uses a source link to GitHub. It's much cleaner than having source within our documentation, and it has the (minor) added advantage of decreasing the build time and size of our docs.

@github-actions github-actions bot added the documentation Anything related to the documentation/website label Mar 9, 2023
@akaszynski
Copy link
Member Author

@jorgepiloto and @Revathyvenugopal162, you may consider making the changes implemented here into a general purpose sphinx extension as I think it's quite useful to link to github.

@codecov
Copy link

codecov bot commented Mar 9, 2023

Codecov Report

Merging #4113 (8ced252) into main (7f5d36b) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##             main    #4113   +/-   ##
=======================================
  Coverage   95.56%   95.56%           
=======================================
  Files          94       95    +1     
  Lines       20213    20246   +33     
=======================================
+ Hits        19316    19349   +33     
  Misses        897      897           

@akaszynski
Copy link
Member Author

@MatthewFlamm, seems that #4111 indeed fixed codecov.

pyvista/utilities/docs.py Outdated Show resolved Hide resolved
Co-authored-by: Tetsuo Koyama <tkoyama010@gmail.com>
Copy link
Member

@tkoyama010 tkoyama010 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@akaszynski akaszynski merged commit a313b23 into main Mar 10, 2023
@akaszynski akaszynski deleted the docs/source-links branch March 10, 2023 23:13
akaszynski added a commit that referenced this pull request Mar 10, 2023
* add linkcode

* Update pyvista/utilities/docs.py

Co-authored-by: Tetsuo Koyama <tkoyama010@gmail.com>

---------

Co-authored-by: Tetsuo Koyama <tkoyama010@gmail.com>
@akaszynski akaszynski mentioned this pull request Mar 10, 2023
akaszynski added a commit that referenced this pull request Mar 11, 2023
* bump to 0.38.4

* update req in earnest

* fix plotter reopening (#4102)

* Update testing-and-deployment.yml

* Update requirements_test.txt

Co-authored-by: MatthewFlamm <39341281+MatthewFlamm@users.noreply.github.com>

* Update testing-and-deployment.yml

* Apply suggestions from code review

* Change source links to github (#4113)

* add linkcode

* Update pyvista/utilities/docs.py

Co-authored-by: Tetsuo Koyama <tkoyama010@gmail.com>

---------

Co-authored-by: Tetsuo Koyama <tkoyama010@gmail.com>

* Fix Plotter docs (#3968)

---------

Co-authored-by: MatthewFlamm <39341281+MatthewFlamm@users.noreply.github.com>
Co-authored-by: Tetsuo Koyama <tkoyama010@gmail.com>
Co-authored-by: Bane Sullivan <bane.sullivan@kitware.com>
@akaszynski akaszynski mentioned this pull request Apr 30, 2023
6 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Anything related to the documentation/website
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants