Bug #11683

Improve installation instructions when Wi-Fi is not working (especially on macOS)

Added by Dr_Whax 2016-08-20 13:40:26 . Updated 2019-01-04 17:58:13 .

Status:
Resolved
Priority:
Elevated
Assignee:
Category:
Hardware support
Target version:
Start date:
2017-12-29
Due date:
% Done:

0%

Feature Branch:
doc/11683-broken-wifi
Type of work:
End-user documentation
Blueprint:

Starter:
Affected tool:
Installation Assistant
Deliverable for:

Description

This ticket is about

  • adding documentation in the installation assistant,
  • warning about potential possibility of lack of WiFi support
  • pointing users to external USB WiFi adapters.

team: sajolida, cbrownstein


Subtasks


Related issues

Blocked by Tails - Feature #15131: Identify USB Wi-Fi adapters that are easily available and work with Tails Resolved 2018-08-30
Blocks Tails - Feature #15941: Core work 2018Q4 → 2019Q2: Technical writing Resolved 2018-09-11

History

#1 Updated by intrigeri 2016-08-27 10:58:23

  • Target version set to 2017

#2 Updated by BitingBird 2017-08-28 19:10:06

  • Description updated

#3 Updated by intrigeri 2017-09-28 11:58:38

  • Subject changed from Improve Mac Tails user experience regarding WiFi to Improve Mac Tails user experience regarding Wi-Fi

#4 Updated by sajolida 2017-11-23 16:52:43

  • Subject changed from Improve Mac Tails user experience regarding Wi-Fi to Improve installation instructions when Wi-Fi is not working (especially on macOS)

#5 Updated by Anonymous 2018-01-15 14:07:24

  • Target version changed from 2017 to 2018

#6 Updated by Anonymous 2018-01-17 14:11:49

  • Description updated

#7 Updated by sajolida 2018-01-19 18:25:03

#8 Updated by sajolida 2018-07-05 15:51:17

  • blocks Feature #15411: Core work 2018Q2 → 2018Q3: Technical writing added

#9 Updated by cbrownstein 2018-08-29 12:45:54

  • QA Check set to Ready for QA

I’ve pushed a branch for review:

https://0xacab.org/cbrownstein/tails/commits/doc/11683-improve-wifi-not-working

#10 Updated by sajolida 2018-09-09 19:20:06

  • blocked by Feature #15131: Identify USB Wi-Fi adapters that are easily available and work with Tails added

#11 Updated by sajolida 2018-09-09 19:22:14

  • QA Check deleted (Ready for QA)

I had this ticket assigned to me because I think we should block on Feature #15131 before documenting that.

Right now I don’t feel like TL-WN722N (version 1.x) as our only option is a good thing to document because most likely users won’t be able to purchase it easly and might purchase instead newer versions that might not work.

I pushed a structural change that I think is important as well. See 871642e7f8.

Please don’t work on this again before I do.

#12 Updated by sajolida 2018-09-11 17:56:53

  • blocked by deleted (Feature #15411: Core work 2018Q2 → 2018Q3: Technical writing)

#13 Updated by sajolida 2018-09-11 17:56:59

  • blocks Feature #15941: Core work 2018Q4 → 2019Q2: Technical writing added

#14 Updated by sajolida 2018-12-17 13:21:13

  • Priority changed from Normal to Elevated

Raising priority now that we know which adapters to document.

#15 Updated by sajolida 2018-12-31 12:25:22

  • Description updated

Updating team as per summit 2018.

#16 Updated by sajolida 2018-12-31 19:57:22

  • Assignee changed from sajolida to cbrownstein
  • QA Check set to Ready for QA
  • Feature Branch set to doc/11683-broken-wifi

Here is a branch. Finally!

#17 Updated by cbrownstein 2019-01-01 07:01:22

  • Assignee changed from cbrownstein to sajolida

I’ve pushed some changes to my branch. Please review.

https://0xacab.org/cbrownstein/tails/commits/doc/11683-broken-wifi

#18 Updated by sajolida 2019-01-04 17:58:13

  • Status changed from Confirmed to Resolved
  • Assignee deleted (sajolida)
  • QA Check deleted (Ready for QA)

I wrote this yesterday already but it seems I didn’t press “Submit” or something…

Thanks for the very fast review!

See your commits 28b97313dc and bfc02ee9f8, it seems like you haven’t read mine d9005d78bd. When you’re doing your reviews, please make sure to always read the Git history, in addition to inspecting the diff. For example with git log -p origin/master..origin/doc/11683-broken-wifi or similar.

I also clarified my intent in the code directly from now with 3b99467cfc.

And merged :)