Skip to content

Fix link to contribution docs#440

Merged
martinRenou merged 3 commits intogeojupyter:mainfrom
martinRenou:fix_checklink
Feb 5, 2025
Merged

Fix link to contribution docs#440
martinRenou merged 3 commits intogeojupyter:mainfrom
martinRenou:fix_checklink

Conversation

@martinRenou
Copy link
Member

@martinRenou martinRenou commented Feb 5, 2025

This should fix the CI


📚 Documentation preview: https://jupytergis--440.org.readthedocs.build/en/440/
💡 JupyterLite preview: https://jupytergis--440.org.readthedocs.build/en/440/lite

@martinRenou martinRenou added documentation Improvements or additions to documentation maintenance Fixing lint errors, changing project metadata, changing tooling, changing dependencies, etc. labels Feb 5, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2025

Binder 👈 Launch a Binder on branch martinRenou/jupytergis/fix_checklink

@martinRenou martinRenou mentioned this pull request Feb 5, 2025
4 tasks
@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2025

Integration tests report: appsharing.space

arjxn-py

This comment was marked as duplicate.

Copy link
Member

@arjxn-py arjxn-py left a comment

Choose a reason for hiding this comment

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

Other than the unexpected RTD failure, it looks good.
RTD fail looks unrelated but worth re-running

@martinRenou
Copy link
Member Author

The RTD failure worries me, it makes me believe I may have broken the latest jupyterlite-xeus release

@martinRenou
Copy link
Member Author

Ok let's get this in since it fixes one CI failure at least

@martinRenou martinRenou merged commit b65b716 into geojupyter:main Feb 5, 2025
12 of 14 checks passed
@martinRenou martinRenou deleted the fix_checklink branch February 5, 2025 10:39
Copy link
Member

Choose a reason for hiding this comment

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

D'oh! Of course. Thanks :)

:::{admonition} Prerequisites
:class: warning
Before beginning this tutorial, JupyterGIS must be installed on your computer (see [Installation instructions](https://geojupyter.github.io/jupytergis/install.html)) or you can use an online version of JupyterGIS (such as [![Jupyterlite badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://geojupyter.github.io/jupytergis/lite/lab/index.html?path=france_hiking.jGIS/)).
Before beginning this tutorial, JupyterGIS must be installed on your computer (see [Installation instructions](https://jupytergis.readthedocs.io/en/latest/user_guide/install.html)) or you can use an online version of JupyterGIS (such as [![Jupyterlite badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://geojupyter.github.io/jupytergis/lite/lab/index.html?path=france_hiking.jGIS/)).
Copy link
Member

@mfisher87 mfisher87 Feb 5, 2025

Choose a reason for hiding this comment

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

Woopsie! Should this be an internal link instead of a full HTTP URL so that the check links job can catch this type of mistake?

Copy link
Member Author

Choose a reason for hiding this comment

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

I'm not sure actually, I don't have a strong opinion on it.

Thankfully check-links allows us to catch this issue early anyway. And those links are not likely to change every month. So I guess it's not a big deal?

Copy link
Member

@mfisher87 mfisher87 Feb 5, 2025

Choose a reason for hiding this comment

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

I'm not sure I understand! Just to be really clear, I'm suggesting:

Suggested change
Before beginning this tutorial, JupyterGIS must be installed on your computer (see [Installation instructions](https://jupytergis.readthedocs.io/en/latest/user_guide/install.html)) or you can use an online version of JupyterGIS (such as [![Jupyterlite badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://geojupyter.github.io/jupytergis/lite/lab/index.html?path=france_hiking.jGIS/)).
Before beginning this tutorial, JupyterGIS must be installed on your computer (see [Installation instructions](../install)) or you can use an online version of JupyterGIS (such as [![Jupyterlite badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://geojupyter.github.io/jupytergis/lite/lab/index.html?path=france_hiking.jGIS/)).

Then if we move documents around in a PR (like #411), the check-links check for that PR would fail.

Copy link
Member Author

Choose a reason for hiding this comment

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

Yep, got it 👍🏽 But the nice thing about keeping URLs to the docs is that when you click on it from the repo you get directed to the docs deployment.

Copy link
Member

Choose a reason for hiding this comment

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

Are there other links in the docs that are full HTTPs urls? As far as I could tell, we're using relative links everywhere else. The thing I'm confused about most right now is why this one is different. Since we have so much syntax in the docs that GitHub can't understand, I assumed it was a non-goal to serve folks who are viewing the docs in GitHub!

HaudinFlorence pushed a commit to HaudinFlorence/jupytergis that referenced this pull request Jan 28, 2026
* Fix link to contribution docs

* Update install docs

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
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 maintenance Fixing lint errors, changing project metadata, changing tooling, changing dependencies, etc.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants