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

Update resource section #2415

Merged
merged 11 commits into from
Mar 6, 2023
Merged

Conversation

joelostblom
Copy link
Contributor

Somehow I missed that this section already existed when opening #2414. It was quite out of date, so I removed packages that haven't seen updates in a few years and added new ones as well a section on the learning resources. I also attempted to make this more discoverable by adding links from the Overview and Gallery pages.

close #2414

@joelostblom
Copy link
Contributor Author

joelostblom commented Feb 22, 2021

Not sure if the doctest will also serve a live preview, but in case it doesn't, here is screenshot of what the section looks like now:

image

@harabat
Copy link
Contributor

harabat commented Feb 24, 2021

@joelostblom
There are also two dashboarding tools, Panel and Streamlit, that might be relevant. While they also support other plotting libraries, Altair features pretty heavily in their communication and communities. Would that be part of the ecosystem?

@joelostblom
Copy link
Contributor Author

Thanks @harabat , that's a good point you bring up. I was personally thinking about this section as tools that are more directly related to Altair rather than just compatible with it. But we do mention gif which is a bit more general, and the Altair dashboard question on Stack Overflow is quite popular so it would make sense to say something about Dashboards I think...

If streamlit starts integrating specific Altair functionality, that might be the natural tool to highlight, but for the time being, I think I will write up a more elaborate example to the SO question with an example from panel, dash and streamlit and then let @jakevdp decide if he thinks that section should be copied in the docs also or maybe just link to it somewhere and mention that Altair is compatible with these tools.

I actually opened a related issue in the dash docs regarding the preferred way to use other plotting libraries, but haven't heard back yet https://github.com/plotly/dash-docs/issues/1068

@jcmkk3
Copy link

jcmkk3 commented Feb 25, 2021

There's also the video series about Altair from calmcode.

@firasm
Copy link

firasm commented Mar 15, 2021

@jcmkk3 - wow Thank you! I wish I had seen those videos a few weeks ago! Definitely will incorporate them as part of my class next time I teach Altair!

@joelostblom
Copy link
Contributor Author

joelostblom commented May 7, 2021

@jakevdp I added a reference to the course I mentioned in the original issue and to the EDA wrapper package I made (let me know if you think logo or name are too official-looking and I'm happy to change). The failing blake test is related to a file that I haven't touched in this PR (altair/sphinxext/schematable.py). This is not the most pressing PR, I know you're very short on time.

@harabat I added a more elaborated reply to the dashboard SO question and linked it from the resource section.

@jcmkk3 @firasm I linked to the calmcode videos as well.

@firasm
Copy link

firasm commented May 7, 2021

Thanks @joelostblom !

What you have is great! I just want to mention a couple of resources that @eitanlees created that I found super helpful:

Maybe Eitan has some more things that will help.

@joelostblom
Copy link
Contributor Author

Thanks @firasm, I agree those are great and @eitanlees already have an open PR #2292 to include many of them in the main user guide which I think is even better than having them here.

doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
Co-authored-by: Stefan Binder <binder_stefan@outlook.com>
@joelostblom joelostblom requested a review from binste March 5, 2023 02:00
sphinxext/altairgallery.py Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
doc/user_guide/ecosystem.rst Outdated Show resolved Hide resolved
joelostblom and others added 5 commits March 5, 2023 17:30
Co-authored-by: Stefan Binder <binder_stefan@outlook.com>
Co-authored-by: Stefan Binder <binder_stefan@outlook.com>
@joelostblom
Copy link
Contributor Author

Thanks for the comments @binste ! I accepted all your suggestions and shortened the title a bit; merging this

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.

Add resource section in the documentation
5 participants