Errata - Part 3 - Reference to edit of config.txt for TV about rpi4-osdev HOT 5 CLOSED

Thanks for your detailed comments! I am travelling this weekend, but will address them as soon as I return on Monday 🙂

from rpi4-osdev.

Actually, I have just discovered the source of my confusion... google actually threw me on to the second page of the tutorial (which is confusingly called "part 1").

However, after reading the github Readme.md I realised that there is actually a page prior to that, which on the website can only be accessed (from the part one page) by changing the URL in the browser to https://www.rpi4os.com/. So this index page is (effectively) part zero (or introduction) - which equivalent to the README.md. On this introduction page, I can now see the lines:

Hook up your RPi4 and make sure it boots into Raspbian. There are plenty of resources online to help you achieve/troubleshoot this. Getting Raspbian up will test that your hardware setup is working properly. Note: because I connected my RPi4 to my (not brilliant) TV, I needed to make an edit in the config.txt file on the SD card (setting the hdmi_safe parameter to 1) to ensure that I could see the screen. Without that, it was just black.

So, the confusion is basically due to fact that the part one page on the website (not the github site) not having any indication that there actually is a previous page before the part 1 page (there is no "previous page" link, or "back"/"back to part zero"/"back to introduction" link)... if that makes sense.

This confusion is compounded by google throwing visitors on to the part one page, rather than the part zero (or "introductory") page.

Possible fixes:

• Add a page 2 of 15 indicator somewhere on the part one page (as well as the other pages with the correspondingly correct page numbers used)
• Add a back to previous page link somewhere on the pages after the introduction (or part zero) page
• Renumber the parts so part one is actually part two (which would/could/might be a pain to implement)
• Something else I haven't thought of

Hopefully all of that makes sense. And apologies for having to complain about a beautifully written tutorial.

from rpi4-osdev.

it might be worth converting hdmi_safe to combine it with a direct link to the RPi docs page, as there are some other things you can do in config.txt that are specific to getting an acceptable TV output (and are referenced on those pages), but dont warrant further comment in the tutorial.

EDIT: haha :) when I first went to review this on the web url (not github) I could not find the link to the next page :)

from rpi4-osdev.

@paulwratt Good suggestion, and I've updated the intro to include a link to the further video options.

To the wider issue, I'm still pondering what the right approach to backlinking etc. is... 🤔

from rpi4-osdev.

OK, temporary fix done to add a link back to the intro from part1. It doesn't solve the problem if you land on part14, for example, (Google has indexed all parts), so definitely something to think about more as I go on. I suspect a ToC would be useful if I could add it non-intrusively on each part...

from rpi4-osdev.