@JamesH65 Is #109 still relevant? Or has the "documentation style guide" changed since then? 🤷

I avoid using the Wifi phrase completely as it's a trademark (yes indeed!) so I always use wireless or 'wireless network'.

I avoid using the Wifi phrase completely as it's a trademark (yes indeed!) so I always use wireless or 'wireless network'.

The trademark is also supposed to only be used if the device in question has undergone, and passed, specific interoperability testing, as I understand it.

specific interoperability testing

https://www.raspberrypi.org/documentation/hardware/raspberrypi/conformity.md ?

specific interoperability testing

https://www.raspberrypi.org/documentation/hardware/raspberrypi/conformity.md ?

The Wi-Fi alliance wants companies to test their devices to check they can successfully interoperate with other Wi-Fi devices.

OK, so back on topic - raspi-config uses the term 'Wi-fi' in the menu. The official trademark spelling is 'Wi-Fi'. So we need an official decision on what term to use before I proceed any further with this one. We seem to have multiple conflicting ideas:

• Liz in 2014 said WiFi is correct
• the Wi-Fi Alliance say Wi-Fi is correct
• James says don't use any variant of wifi, but 'wireless', 'wireless networking' etc. instead.

If Raspberry Pi could make an official decision that would be most helpful.

I've found the style guide and Wifi is specifically mentioned (well, rather, someone posted me a link to it when I asked where it was)

https://github.com/raspberrypilearning/style-guide/blob/master/style-guide.md

I've found the style guide and Wifi is specifically mentioned (well, rather, someone posted me a link to it when I asked where it was)

https://github.com/raspberrypilearning/style-guide/blob/master/style-guide.md

Thanks James - that's the one I was after. I see it solves the "how to refer to wireless networking stuff" problem as well, which is extremely useful. Buy that person a beverage of their choice 😁

The standardisation of how we refer to wireless network/wifi is a big change that is bogging this seemingly simple PR down a bit. I have manually reverted all my proposed changes to how wifi is referred to in this file, and would propose that this PR be integrated without touching the 'wifi' elements at all.

If there are no other objections, this PR looks ready to go.

I will address the issue of wireless/wifi in a separate PR, since it will require changes across multiple files and repos (raspi-config is currently wrong, as I read the style guide).

Looks like quite a number of places in the SW that use it - currently in discussion internally.

Looks like quite a number of places in the SW that use it - currently in discussion internally.

Yes, it's a tricky one. Wi-Fi is a pretty well understood term for non-techies, "wireless networking" not so much I think. It's kind of like Americans saying "Kleenex" for "tissues" almost. I've even heard some folk call a network cable "the wifi cable".

@JamesH65 please also ping me when there's a decision.

@XECDesign Will email you offline with internal discussion.

Are we OK to merge this? Or shall I merge the Wifi->wireless fix up first, then this can rebased over it?

Actually, better to merge this and the other related PR, then do the wifi change. So everyone OK for this to be merged?

@lurch @andrum99 For final OK

Whatever you think is easiest. 👍

I'm still not convinced we need the specific "Note that with the latest Buster Raspbian release" callout, but lets get this merged, do the big WiFi change, and we can come back to it later.

I'm still not convinced we need the specific "Note that with the latest Buster Raspbian release" callout, but lets get this merged, do the big WiFi change, and we can come back to it later.

👍