Raspberry Pi Forums

In my initial investigation into the Foundations pages at https://www.raspberrypi.org it did not take long to find a few pages that "need a good tidy up". I also looked at the Github site where the pages are held.

From the RPF Raspberry Pi site, Help button, to Documentation, to Set Up to SD-cards
(Page: https://www.raspberrypi.org/documentati ... d-cards.md)

this has links to:
https://www.raspberrypi.org/products/model-a/
https://www.raspberrypi.org/products/model-b/
https://www.raspberrypi.org/products/model-a-plus/
https://www.raspberrypi.org/products/model-b-plus/
https://www.raspberrypi.org/products/ra ... 2-model-b/
(pages with a picture, a brief description, and 'buy from' links)

These pages all link back to:
https://www.raspberrypi.org/products/

This has links to:
https://www.raspberrypi.org/products/ra ... 2-model-b/
https://www.raspberrypi.org/products/model-b-plus/
https://www.raspberrypi.org/products/model-a-plus/
https://www.raspberrypi.org/products/pi-zero/
(and including the compute module, but not the model A or model B)

The pages above are not on Github, but this does have a single 'Models' page (https://github.com/raspberrypi/document ... are/models). This page has detailed descriptions of the model B+, model A+, model B, model A and the Compute Module ( not the Pi2 or the Zero)

There is an Issue raised on Github, number 196, Additions to quick start guide, March 2015, (adding labels to the pictures as a guide for new users when connecting up the Pi).

I don't know how to create an Issue to tidy up the pages listed above, as there are several issues.
* The page with a picture sould be merged with the page with the description, with labels (numbers) added to the picture to match the numbered features list. Also include a picture of the corresponding connector and socket?
* The pages need to be on Github, and contain a link at the bottom to the Github page and perhaps a 'last updated' date?
* These pages need to be checked so they have the correct information (e.g. the Pi-zero picture page shows the distributers are Farnell and RS)
* The navigation across the site needs to corrected so it links to the correct (new) pages.
* The pages should include the model A and the model B, which are now not sold new, but might be sold as pre-owned or 'found in a cupboard'

The purpose of these pages would be to help new users connect the Pi up, or to help them to identify which Pi they have (e.g. when a user posts on the Forum, and can be directed to these pages if necessary).

How can I get a review like this one taken forward and implemented? I can help with that if I know what this process is

I think there is a page somewhere describing how to make changes and send in pull requests, cannot find it right now.

Have you looked here....

https://github.com/raspberrypi/documentation


Usual process is file report, make changes locally, send in as pull request. That will get reviewed and merged when OK. You'll need to read up on github usage if not already familiar. Contributions are very welcome.

jamesh wrote:I think there is a page somewhere describing how to make changes and send in pull requests, cannot find it right now.

Have you looked here....

https://github.com/raspberrypi/documentation


Usual process is file report, make changes locally, send in as pull request. That will get reviewed and merged when OK. You'll need to read up on github usage if not already familiar. Contributions are very welcome.

As OP says this is mainly about pages that are not in the documentation, so you can't use pull requests.
And I'm not sure if the documentation repo is the best place to report issues with stuff that is not part of that repo.

I can see that there is a value in having the community take a share in maintaining the documentation about the use of RPi products. I have taken part in that process myself.

But surely the factual information about what the product range is has to be absolutely the responsibility of RPF/RPTL?

* These pages need to be checked so they have the correct information (e.g. the Pi-zero picture page shows the distributers are Farnell and RS)

As recent events have shown, volunteeers can only offer (sometimes wild) guesses about the manufacturing and distribution policies that RPF/RPTL adopt for their differing products - this would be an opportunity to introduce some clarity before the next latest/greatest product comes along to muddy the waters even more.

Kudos to @Navyscourge for raising the profile of this.

OK, so the product pages in the docs have been completely deleted, it's now the product pages on the main website that describe each product (sad face - I wrote the original pages!). One omission I think is a table comparing devices.

https://www.raspberrypi.org/products/

Are you saying that these pages are incorrect?

I actually did not check all the pages in detail, since I did not know which ones were the correct ones to be using. However, just to repeat two of the points from my first post:

https://www.raspberrypi.org/products/pi-zero/ shows a 'picture' link to the Distributors. My understanding from other threads is that the Pi-Zero is not available through Farnell and RS, but through others.

https://www.raspberrypi.org/products/ shows pictures and links to models currently available to buy new. The model A and model B are not listed, and might be bought 'used' on ebay, but have significant differences, such as SD card and GPIO pins. I was thinking that when a new user posts that they have found their old Pi that they had dumped in a drawer, and reported a difficulty with any advice or following guides, we could get them to check these pages and easily identify their model (is there a better way?)