py5coding / py5book

juypter book repo for py5
https://py5coding.org/
62 stars 10 forks source link

Contributions? #3

Open Lioncat2002 opened 2 years ago

Lioncat2002 commented 2 years ago

Hello!
I would like to contribute to the documentations(mainly the how tos) of this project,
is there a contributor's guide that I need to follow while writing these how tos?

hx2A commented 2 years ago

Hi, @Lioncat2002 ! No, there is not yet a contributors guide. I feel like there should be.

This project is right at the cusp of moving from a 1-person project to a project that multiple people contribute to, and there are going to be things that need to be done to facilitate that change. I don't claim to know all of the things that need to be done or claim to be able to do all of those things. Please bear with me as the changes takes place. One of the things I'm hoping for with the GSoC program is that a lot of those things will get worked out, and it will be easier for contributors to make contributions as a result.

What how-tos do are you thinking of writing? Are you familiar with Jupyter Book? I would start by getting up to speed on that and writing some documentation in a notebook.

edurojasr commented 1 year ago

Hi @hx2A

I'm back, I was one of the first to ask how contribute in writhing, tutorials, documentation, or even challenges or fun stuff. Now I think I have plenty of knowledge using Jupyter, I have been using python a lot even streamlit at work I still have my thesis ongoing but I think this coming year I would like to help since my health is improving.

I'm glad to see a lot of changes around here, just point me in where is the guide or discussions and I cant star making some tutorial like in p5js or processing.

I'm really happy to see this project thrive! :heart:

hx2A commented 1 year ago

Hello, @edurojasr ! I do remember you. Welcome back.

I should tell you I am currently swamped preparing for a gallery show in 2 weeks, but perhaps @tabreturn or @villares can help find a way for you to contribute?

Right now we are trying to finish up the GSoC tutorials. These are a set of new tutorials targeted to beginners. There is a discussion thread started here https://github.com/py5coding/py5generator/discussions/205 explaining where we are. Perhaps you can read the tutorials and provide feedback? It would be helpful to get a fresh pair of eyes on them.

edurojasr commented 1 year ago

Hi @hx2A! I know you are super busy.

But a need to clarify: The work for righting tutorials and guides are under "tutorials" in the left side panel in the web page, and the GSoC are in the "intro to py5 and Python" drop-down.

All of that segmentes are Jupyter notebooks in this repo?

Just a quick look to the order of the tutorials in the webpage and I already have several questions 😅.

Where should I give the feedback? I'm also ready to wright some tutorials

villares commented 1 year ago

Great to have you here, Eduardo!

You can open issues to give feedback on particular items.

Myself I'm trying to use the discussion forum at the py5generator repo to test ideas and I think we could discuss new tutorials there too!

I'm curious about the notebooks workflow too, I tried forking this some time ago and I'll wait for more instructions.

On Mon, 5 Dec 2022, 02:08 Eduardo Rojas Rodríguez, @.***> wrote:

Hi @hx2A https://github.com/hx2A! I know you are super busy.

But a need to clarify: The work for righting tutorials and guides are under "tutorials" in the left side panel in the web page, and the GSoC are in the "intro to py5 and Python" drop-down.

All of that segmentes are Jupyter notebooks in this repo?

Just a quick look to the order of the tutorials in the webpage and I already have several questions 😅.

Where should I give the feedback? I'm also ready to wright some tutorials

— Reply to this email directly, view it on GitHub https://github.com/py5coding/py5book/issues/3#issuecomment-1336759735, or unsubscribe https://github.com/notifications/unsubscribe-auth/AA4GADGQGETEFIKDLVXY5DDWLV2GBANCNFSM5TDCDHLQ . You are receiving this because you were mentioned.Message ID: @.***>

villares commented 1 year ago

Cheers @edurojasr, how about a Video Capture and OpenCV tutorial, wink, wink... https://github.com/py5coding/py5generator/discussions/206#discussion-4629323