processing / p5.js Public
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
documentation help wanted! #2865
Comments
For anyone who wants to work on adding missing examples and doesn't know where to start, this seems to be where there are still examples missing right now:
|
I would love to help out porting the tutorials from processing (https://processing.org/tutorials/) to p5. @lmccart I can work on more text based tutorials such as "typography" and "strings and drawing text" since I noticed they are still missing. Or do you have a particular one you would like me to start on first? |
@faithwyu that would be great! |
I'm going through the processing.org examples - some of the stuff that is missing seems to address the language itself as opposed to the library. For example, processing.org talks about "Integers and Floats" and "Datatype Conversions". Should I make Javascript equivalent entries like "Numbers" and "Dynamic Types"? |
@raulgrell good question. not yet. we're not set up with the right website/reference infrastructure yet to be able to display those correctly. |
Hi, I'd like to work on porting the examples from the processing example page to the p5.js example page. |
|
@lmccart I will start with porting the Data: Integers and Floats example. |
@lmccart Should I call this example Data: Numbers instead? Since there is only the Number datatype for numbers in JavaScript. |
@cecilebertin that makes sense to me |
Hi @lmccart, I made a pull request for the Numbers example. |
@lmccart - I was trying to ask the same question as @cecilebertin, but I seem to have suffered a momentary lapse of eloquence =P Unfortunately, that also means I'm not sure I understood your reply. Did you mean you don't yet have a way to show something like console output? |
@raulgrell oh! i'm sorry, i misread and thought you were talking about the processing reference entries where they have entries for "String" or "Float". now I have reread and realize you are referring to the examples page. yes, I think that makes sense to rename as you suggest! |
So sorry @raulgrell !! I didn't see you wanted to work on this. I only checked the issues in the processing/p5.js-website repository to check if someone was working on this example. |
@lmccart @cecilebertin No worries, I could have been clearer! There are still more examples to do =) I'll send a PR for Strings, and possibly something for Data Types as well that deals with type coercion and whatnot |
thanks everyone! |
Oh dear, I completely forgot about this! That weekend I participated in a Game Jam where we actually used p5 to make a little neuroscience experiment disguised as a game and I never got round to finishing the examples... check it out: https://github.com/raulgrell/NeuroJam Unfortunately, I've got a big presentation for uni on Monday and I won't be able to dedicate any time to this right now... |
thanks @raulgrell no worries. we'd welcome the additions anytime, no rush. thanks for sharing the game jab result, it's great! |
Can this be updated please? Thank you. |
I have some thoughts and would like your feedback if possible: The asterisk-design-element on the https://p5js.org/get-started/ page causes an accessibility issue; the language controls are inaccessible to color blind users due to the colors of the asterix and the color of the languages. Either move the asterix below the language or change colors of the language bar on that page
|
Could someone provide some guidance of what needs help with documentation rn? I really want to start contributing to the community, but most of the open issues right now are either already being worked on or out of my experience range. Thanks! |
thank you @Rizz0S, i think the most straightforward help to contribute, |
Hello I noticed a tiny incoherence in this reference page and decided to fix it (in a way that makes sense to me). I created a pull request draft #4817 and would appreciate if I could get some feedback on it :) Best, |
Change distance example to be more reasonable (addresses #2865)
Hey if this issue is open I would like to contribute. |
hi @shreyan-invalid yes, you are welcome to work on this! |
Hi!
@mcturner1995 What do you think of this? Happy to have a chat to see how we can best use our resources to make p5.js better without hindering anyone else's work. |
Hi @Nolski, this is wonderful! It would be very helpful to the project. I'd be happy to chat with you about this. I'm in an extreme zoom overload state these days, could we possibly discuss via email? You can write to hello@p5js.org and it will come through to me. |
I saw a space in the reference page under the foundation. But under other header I didn't see any space. Is it a bug or something else? Just letting you know. |
@AndrewAung11 yes this could be considered a bug. If you are interested in working on it, you are welcome to! |
hi, I was considering starting a documentation in French. would anyone be interested ? |
Hi @LouisJustinTALLOT, I don't think there is a plan to add additional translations at this point, maybe it can be pitched as a GSoC or Fellowship project but that's not a decision I'm involved with. That's for official translations though, for unofficial translations we definitely welcome anyone to do it and publish on their own URL, you can then share that URL with us so we can list it as an unofficial translation. On a not totally unrelated note, I'm working on some research into this area, if you are able to would you be interested in trying out some experiments I'll be working on? Basically I'm looking into the documentation translation process and possibly creating a software or workflow for translations that fits into the overall documentation process. |
hi @two-ticks thanks for your interest! I would suggest looking at https://processing.org/examples/ and seeing if you can port any over to http://p5js.org/examples. I think there are several missing from the math categories right now. |
Hi all! I'd love to contribute whatever would be most helpful right now. :) |
Hello !! I would like to contribute. |
I would like to help! |
Hello would love to contribute~ |
I would love to contribute but need little more explanation where you wanted update |
I would love to contribute but need little more explanation where you wanted update |
Hi👋 👋 👋
We are using this issue to focus on documentation! Documentation is essential for new learners and experienced programmers alike. It helps make our community inclusive by extending a friendly hand to those that are less familiar with p5.js. It also helps us find the bugs and issues with the code itself, because we test and try things out as we document.
There are several ways to contribute, you can read more about them on this page.
If you are adding some documentation, please comment below. And don't forget to add yourself to the contributors list!
Welcome! We're so glad you're here!
❤️ the p5.js community
The text was updated successfully, but these errors were encountered: