Update wpa_supplicant.md #523
Conversation
add details on how to use wpa_cli and wpa_supplicant based on my reading experience and real life experiment on this doc.
|
At least enabling the service is redundant, users should refer to the linked page if they don't know how services are enabled, otherwise we would have a copy of |
|
@Duncaen does it mean once the soft link happens the runit will run the service immediately? As a new user who is referring to the doc during instillation, it is a bit easier to have all information needed in the front, especially for the networking setup. And I found |
Review the document flow and make changes based on review.
Yes it will start as soon as the service directory is scanned, which should happen within 5 or 14 seconds not sure, Regarding the new update, this is exactly why this should be documented in the appropriate file, now we would have to duplicate a lot more text over all pages that enable a service, which doesn't really make it better. |
|
@Duncaen Sure. I think the the time delay need to be mentioned . And using |
|
Yes but the right place would be https://docs.voidlinux.org/config/services/index.html#enabling-services and not every single page that wants you to enable a service, linking to that page should be sufficient for new users who don't know how to enable services. |
|
A little bit of redundancy is not bad at all. Just referring the general enabling services section does not solve the problem of specific service, i.e I have to look up the correct name of service file/directory. Giving the right command up front would be so much easier. Especially referring to my experience when I cannot get Internet access in void installation and starting to search the Internet, find if I am missing wifi firmware etc. And in void-installer shell, there is not auto-completion of directory and filenames. |
|
We've decided that redundancy is just hurting maintainability and reading experience, exactly this example was discussed and is mentioned in the style guide:
https://github.com/void-linux/void-docs/blob/master/CONTRIBUTING.md#general |
Update the link to enabling service section.
Update the link to enabling service section.
|
@Duncaen I don't think it hurts reading experience since it provides whatever information is needed by a reader who is looking for the exact command. But I don't want to spend time on arguing thus removing the ln command. |
| Then you need to run `rfkill` to make sure your radio device is not blocked. | ||
|
|
||
| Run `rfkill unblock id|type` if it is shown blocked. |
There was a problem hiding this comment.
Information about rfkill should be added to the general network page, because it applies to wpa_supplicant and IWD, as well as any other daemon we decide to add.
There was a problem hiding this comment.
It is already in, but we can perhaps expand it. https://docs.voidlinux.org/config/network/index.html
| ``` | ||
| # wpa_cli -i wlp2s0 | ||
| (wpa)$ add_network 0 | ||
| (wpa)$ set_network 0 ssid "wifi_name" | ||
| (wpa)$ set_network 0 password abc123 | ||
| (wpa)$ enable_entwork 0 | ||
| (wpa)$ quit | ||
| ``` |
There was a problem hiding this comment.
Wow, their man page fails to even mention these *_network commands... It would be nice if we could get them added to the upstream man page.
| to specify which network interface to use via the `-i` option. Not doing so can result in various `wpa_cli` commands (for example, `scan` and | ||
| `scan_results`) not producing the expected output. | ||
|
|
||
| Sample Setup Commands: |
There was a problem hiding this comment.
"An example of the procedure to connect to an access point called wifi_name can be seen below:"
| (wpa)$ quit | ||
| ``` | ||
|
|
||
| ## More on wpa_supplicant |
There was a problem hiding this comment.
I don't love this title. I think the page could be reorganized to not require it.
| @@ -3,7 +3,29 @@ | |||
| The `wpa_supplicant` package is installed by default on the base system. It | |||
| includes utilities to configure wireless interfaces and handle wireless security | |||
| protocols. To use wpa_supplicant, you will need to enable [the wpa_supplicant | |||
| service](#the-wpa_supplicant-service). | |||
| service](../services/index.md#enabling-services). | |||
There was a problem hiding this comment.
https://docs.voidlinux.org/config/network/wpa_supplicant.html#the-wpa_supplicant-service has a link to the part about enabling services...
This could be made clearer, but whenever we say "enable
New images will hopefully include the void-docs package, allowing you to access the documentation even when offline.
Is it running |
add details on how to use wpa_cli and wpa_supplicant based on my reading experience and real life experiment on this doc.