add terminal equivalents to the various commands #1624
Conversation
Adding terminal/shell equivalents to commands. It makes setting up raspios a lot easier since the various options are buried in the script, which doesn't have a manpage or a `--help` option. I'm somewhat torn on the level of detail to give, I thought about prefixing each with "for expert users" or similar. I've banged my head against the locale and keyboard options, especially, so hopefully Future Me will benefit, if nobody else. Also adding some examples of why pixel doubling might be wanted.
| @@ -2,7 +2,7 @@ | |||
|
|
|||
| This page describes the console based raspi-config application. If you are using the Raspberry Pi desktop then you can use the graphical Raspberry Pi Configuration application from the Preferences menu to configure your Raspberry Pi. | |||
|
|
|||
| `raspi-config` is the Raspberry Pi configuration tool originally written by [Alex Bradbury](https://github.com/asb). It targets Raspberry Pi OS. | |||
| `raspi-config` is the Raspberry Pi configuration tool originally written by [Alex Bradbury](https://github.com/asb) and lives at [github.com/RPi-Distro/raspi-config](https://github.com/RPi-Distro/raspi-config/tree/master/raspi-config). It targets Raspberry Pi OS. | |||
There was a problem hiding this comment.
Perhaps "which now lives at" ?
Also, not sure we need the full tree and branch info, rather than just a link to the repo?
There was a problem hiding this comment.
I don;t like the phrase "lives at" either. "Is hosted at" or similar?
| @@ -60,7 +60,9 @@ Generally speaking, `raspi-config` aims to provide the functionality to make the | |||
| ### Change User Password | |||
|
|
|||
| The default user on Raspberry Pi OS is ```pi``` with the password ```raspberry```. You can change that here. Read about other [users](../linux/usage/users.md). | |||
|
|
|||
|
|
|||
| From the console, this can be changed with `passwd`. | |||
There was a problem hiding this comment.
Isn't that already mentioned on the "users" page that's being linked to? I think this repo generally tries to avoid having duplicate information in multiple places.
|
Having now read the full PR, I'm wondering what the value of these "from the console" additions are?
Is there a deficiency in raspi-config's capabilities? 🤷♂️ Maybe file a bug at https://github.com/RPi-Distro/raspi-config/issues ?
Would the same thing be useful on https://www.raspberrypi.org/documentation/configuration/config-txt/video.md ? |
|
Whilst I understand the thinking behind the change (teach teach teach!), this is a page specifically describing raspi-config, so adding the console commands doesn't seem right, on this particular page. If you are using raspi-config, you don't need the terminal commands. What was the reasoning behind the change - did raspi-config just not work correctly? I would expect it to just work for the vast majority of users? |
If it's not wanted, that's fine- my objection is that it is presented as the only documented way to do things, especially those that are fairly Pi-specific, like enabling the camera or setting the wifi or keyboard locales. There's certainly a subset of users who want a consistent or repeatable way to configure one or more Pis without needing to write down "human" steps. |
|
That's fair comment. The issue is therefor, should it be on that page, or elsewhere. Hmm. Let me have a think. |
@tedder Have you seen that Although of course if you really want to work out what raspi-config itself is doing under the hood, then that's the beauty of everything being OpenSource 😍 |
Yeah, that's what got me started down this path, since I didn't see a manpage or I missed, however, how the
Including the documentation! :) |
Haha, indeed 😀 However much of the Raspberry Pi documentation is beginner-oriented (which IIRC was also one of the initial motivations for
I'm not sure what's "dangerous" about ssh, but this describes the easiest way of non-interactively enabling SSH on a Pi. |
|
In light of #1911 is this PR still relevant? If there is supporting third-party documentation outside of this repo, and there hasn't been much recent progress I'd be inclined to close it? This feels very much non-Raspberry Pi specific material and therefore outside the scope of the more lightweight documentation set? |
|
I'm fine with it being closed (if needed) and happy to see a revamp on the docs. |
Adding terminal/shell equivalents to commands. It makes setting up raspios a lot easier since the various options are buried in the script, which doesn't have a manpage or a
--helpoption. I'm somewhat torn on the level of detail to give, I thought about prefixing each with "for expert users" or similar.I've banged my head against the locale and keyboard options, especially, so hopefully Future Me will benefit, if nobody else.
Also adding some examples of why pixel doubling might be wanted.