search

coreos / fedora-coreos-docs

Documentation for Fedora CoreOS
https://docs.fedoraproject.org/en-US/fedora-coreos/
Other
49 stars 119 forks source link

Add a doc page about wifi #629

Closed jbtrystram closed 2 months ago

jbtrystram commented 2 months ago

Some wifi-firmwares will be split into sub-packages in fedora 40 We will keep them in until fedora 41, but display a warning message in the console. This messages links to this FAQ entry.

See https://github.com/coreos/fedora-coreos-config/pull/2963 See https://github.com/coreos/fedora-coreos-tracker/issues/1575

travier commented 2 months ago

Ideally, we should stop adding things to the FAQ as it's really hard to find them and for people to search for.

As this is about networking, this should go into the existing Network Configuration page or another one dedicated to WiFi.

dustymabe commented 2 months ago

or another one dedicated to WiFi.

yes. we have an outstanding action/todo for that page to exist.

If @jbtrystram feels motivated he can add that page here too. Otherwise I think the FAQ is fine since we do have a search function in the docs and the FAQ entries are useful to link back to.

dustymabe commented 2 months ago

looking good!

once we get the last package removed from that list we can merge.

does it look good when you render the docs site locally?

dustymabe commented 2 months ago

looking good!

ok I spoke too soon :)

I see now that you have converted this into not a FAQ entry, but a standalone page. I think you are trying to address https://github.com/coreos/fedora-coreos-tracker/issues/862#issuecomment-862678654 which is awesome!

but... I think doing that will require more work here. We need to address more than just the missing firmware. We need to give some background on our stance on Wifi in general and then explain what to do to enable it.

If you want I can take a crack at this and push a commit up to this PR.

jbtrystram commented 2 months ago

but... I think doing that will require more work here. We need to address more than just the missing firmware. We need to give some background on our stance on Wifi in general and then explain what to do to enable it.

If you want I can take a crack at this and push a commit up to this PR.

You definitely know more context than me there, so if you have the time that would be awesome

dustymabe commented 2 months ago

ok I added a commit here that adds more context to the documentation page and then splits out the pieces about the wifi firmware dropping into a FAQ entry again.

travier commented 2 months ago

Thanks @jbtrystram and @dustymabe for the work on the docs here