Open sambensim opened 1 month ago
sambensim
commented
1 month ago Also, if I've found typos in the docs, how do I report them? If I open an issue, is a typo a bug? (everything's still working, but I'm not advocating for something new either.)
Haiz14
commented
1 month ago Yep, some links are all broken, especially the getting-started one.
Qianqianye
commented
1 month ago Thanks @sambensim, I will assign you on this. Please feel free to open an pull request with the links fixed. If you find typos, please open an issue using 'Find a bug' template.
Thanks @Haiz14 for raising the issue about the 'Get started' link, it should be at https://p5js.org/tutorials/get-started. Could you let us know where the links are broken?
wagedu
commented
4 weeks ago Hi, I found a broken link too. Not sure if it's better to open a new issue or add it here, following the subject... Just in case: when searching for HSB, the result (Reference: HSB) takes me to a 404 page: https://p5js.org/reference/p5/constants/HSB
Stefterv
commented
2 weeks ago A lot of Google's search results still use the old site's links, they are not broken so I suppose why they aren't updated yet a quick redirect in the JS would be helpful
example: https://p5js.org/reference/#p5/windowResized is still referenced from Google, should be https://p5js.org/reference/p5/windowResized/
aleannab
commented
1 day ago @Qianqianye Not sure if it's better to add it here or open a new issue, but there are a TON of additional broken links spread across many of the Contribute Subpages.
I saw that #461 has been opened specific to Contributor Guidelines. So here is a comprehensive list of all the other pages. I added what I assumed the link should direct to. There are a few (marked ???) that I am unsure about.
| Source link text | Should direct to: |
|---|---|
| At the 2019 Contributors Conference, p5.js made the commitment to only add new features that increase access (inclusion and accessibility). | https://p5js.org/hi/events/contributors-conference-2019/ |
| Making p5.js error messages more helpful and supportive to people using the tool (e.g., the p5.js Friendly Error System (FES)) | https://github.com/processing/p5.js/blob/main/contributor_docs/friendly_error_system.md |
| Hosting community events (e.g., p5.js Access Day 2022, | https://p5js.org/events/p5js-access-day-2022/ |
| I am Disabled: On Identity-First Versus People-First Language. | ??? (page no longer exists) |
| Source link text | Should direct to: |
|---|---|
For more on describe() visit the web accessibility contributor documentation. |
https://p5js.org/contribute/contributor_guidelines/#accessibility |
| The contributor guidelines document is also a good place to start. | https://p5js.org/contribute/contributor_guidelines/ |
| Source link text | Should direct to: |
|---|---|
| The only exception is explaining how to create libraries. | https://p5js.org/contribute/creating_libraries/ |
| Examples: src/data/examples/assets | ??? |
| Reference Pages: src/templates/pages/reference/assets | ??? |
| Learn Pages: src/assets/learn | ??? |
| Source link text | Should direct to: |
|---|---|
| See the Friendly Error performance test. | https://github.com/processing/p5.js-website/blob/main/src/content/contributor-docs/en/friendly_error_system.mdx |
| Source link text | Should direct to: |
|---|---|
| The FES is a part of the p5.js’ internationalization effort. | ??? |
| Source link text | Should direct to: |
|---|---|
| First, ensure your method has inline documentation with the full list of your parameters. | https://github.com/processing/p5.js/blob/main/contributor_docs/contributing_to_the_p5.js_reference.md |
| Unit Testing and Test Driven Development by Andy Timmons | ??? (linked document is private) |
| Contributors Doc: Unit Testing | https://github.com/processing/p5.js/blob/main/contributor_docs/unit_testing.md |
| For more in-depth information about the design and technical aspects of FES, please refer to the FES README document. | https://github.com/processing/p5.js/blob/main/contributor_docs/friendly_error_system.md |
| Source link text | Should direct to: |
|---|---|
The GitHub Action “New p5.js release” is triggered on a tag that matches the pattern v*.*.* |
??? |
| Source link text | Should direct to: |
|---|---|
| If you want to use p5.js with a screen reader, visit the Using p5.js with a Screen Reader tutorial. | https://p5js.org/tutorials/p5js-with-screen-reader/ |
| Source link text | Should direct to: |
|---|---|
| Read our p5.js WebGL architecture overview to understand how WebGL mode differs from 2D mode. | https://github.com/processing/p5.js/blob/main/contributor_docs/webgl_mode_architecture.md |
| Read our contributor guidelines for information on how to create issues, set up the codebase, and test changes. | https://p5js.org/contribute/contributor_guidelines/ |
| Source link text | Should direct to: |
|---|---|
| If you are looking for help using WebGL mode in your sketches, consider reading the WebGL tutorials on the p5.js Learn page instead. | https://p5js.org/tutorials/#webgl |
Qianqianye
commented
6 hours ago Hi all, thanks for listing all the broken links. This is related to issue #461.
To share some context: all the pages included in p5js.org/contribute are generated directly from the contributor_docs folder within p5.js library GitHub repo. So there are two types of links for one documentation, below are two examples:
The .md extension in some link path causes some known broken link issues.
We think that all links in the documentations, including all the pages in p5js.org/contribute and their source md files in the contributor_docs folder in p5.js library GitHub repo, will go to the website page link, not GitHub library contributor_docs link. So if we fix the links, we'd fix the link in both p5js.org/contribute and the contributor_docs folder, to keep everything in sync.
@davepagurek @limzykenneth We discussed before that we could potentially solve this with some scripts. Before the automation script is done, would it make sense to assign some interested contributors to fix the broken links manually? If so, different contributors can take on fixing links in different docs to better organize the effort.
Most appropriate sections of the p5.js website?
Contribute
What is your operating system?
Mac OS
Web browser and version
126.0.6478.126 (Official Build) (arm64)
Actual Behavior
Various links on the Contribute page are broken (lead to "page not found") Starting here:
Expected Behavior
To be taken to the correct page:
Steps to reproduce
Would you like to work on the issue?
Yes (but I think it'll take like 3 secs so idc)