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

fix docs #321

Merged
merged 4 commits into from
Sep 25, 2023
Merged

fix docs #321

merged 4 commits into from
Sep 25, 2023

Conversation

LucaMarconato
Copy link
Member

@LucaMarconato LucaMarconato commented Jul 13, 2023

  • Added installation instructions for M1/M2
  • Added explicit links to the docs and to the repos in the docs landing page (feedback from @ilia-kats)

@codecov
Copy link

codecov bot commented Jul 13, 2023

Codecov Report

Merging #321 (00d77b1) into main (cdddb8b) will not change coverage.
Report is 23 commits behind head on main.
The diff coverage is n/a.

❗ Current head 00d77b1 differs from pull request most recent head d427562. Consider uploading reports for the commit d427562 to get more accurate results

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #321   +/-   ##
=======================================
  Coverage   90.75%   90.75%           
=======================================
  Files          36       36           
  Lines        4630     4630           
=======================================
  Hits         4202     4202           
  Misses        428      428           

@@ -46,9 +64,19 @@ Alternative you can clone the repository and do an editable install with:
pip install -e .
```

This is the reccommended way to install the package in case in which you want to contribute to the code. To update the package you can use `git pull`.
This is the reccommended way to install the package in case in which you want to contribute to the code. In this case, to subsequently update the package you can use `git pull`.
Copy link
Collaborator

Choose a reason for hiding this comment

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

In that case, wouldn't we prefer people to create a fork first?

Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
This is the reccommended way to install the package in case in which you want to contribute to the code. In this case, to subsequently update the package you can use `git pull`.
An editable installation is the best option if you want to contribute to the development of spatialdata.
Check out our [contributing guide](https://spatialdata.scverse.org/en/latest/contributing.html).

explaining forking goes beyond the scope of installation instructions.
But we can use the opportunity to funnel people to the development guide.

Copy link
Collaborator

@melonora melonora Sep 22, 2023

Choose a reason for hiding this comment

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

Yes in any case for Numfocus we do require a contributors guide or another option would be to create a complete installation guide, similar to napari. All I am saying is that we do not necessarily want people to contribute by directly installing from main in this repo and then pushing their code. This was just there for the initial developers.

Copy link
Member Author

Choose a reason for hiding this comment

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

Thanks for the comments. It's hidden but it's there: https://github.com/scverse/spatialdata/blob/main/docs/contributing.md.

I will modify installation.md to quickly mentione forks.

@LucaMarconato LucaMarconato merged commit 4367b46 into main Sep 25, 2023
5 checks passed
@LucaMarconato LucaMarconato deleted the fix/docs branch September 25, 2023 08:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants