network_connection.md

@@ -373,23 +373,23 @@ Onion menu
 ----------
 
 Expand the onion menu to provide feedback on the status of the
-connection to Tor.
+connection to Tor:
 
 ![onion_menu_-_not_connected](network_connection/onion_menu_-_not_connected.png)
 
 ![onion_menu_-_connecting](network_connection/onion_menu_-_connecting.png)
 
-![onion_menu_-_with_bridges](network_connection/onion_menu_-_with_bridges.png)
-
 ![onion_menu_-_without_bridges](network_connection/onion_menu_-_without_bridges.png)
 
+![onion_menu_-_with_bridges](network_connection/onion_menu_-_with_bridges.png)
+
 Pop up the onion menu when the Wi-Fi gets disconnected:
 
 ![onion_menu_-_disconnected](network_connection/onion_menu_-_disconnected.png)
 
 ![onion_menu_-_reconnecting](network_connection/onion_menu_-_reconnecting.png)
 
-Add a disabled Wi-Fi icon when the Wi-Fi is not connected.
+Add a disabled Wi-Fi icon when the Wi-Fi is not connected:
 
 ![onion_menu_-_no_wi-fi](network_connection/onion_menu_-_no_wi-fi.png)
 
@@ -407,6 +407,9 @@ Empty template:
 
 ![tor_connection_-_empty](network_connection/tor_connection_-_empty.png)
 
+The following screenshots correspond to the content of the right part of
+this template.
+
 Without hardware Wi-Fi
 ----------------------
 
@@ -435,21 +438,17 @@ bridges anyway:
 
 ![autoconfig_-_bridges_option](network_connection/autoconfig_-_bridges_option.png)
 
-Help:
+Toggle this help below:
 
 ![autoconfig_-_bridges_option_help](network_connection/autoconfig_-_bridges_option_help.png)
 
-Configure:
-
-![autoconfig_-_bridges](network_connection/autoconfig_-_bridges.png)
-
 Autoconfig
-==========
+----------
 
 If the user chooses autoconfig, we automate as much as we can:
 
 - Captive portal detection using an HTTP ping on
-  [http://clients3.google.com/generate_204]. See [captive portal
+  http://clients3.google.com/generate_204. See [captive portal
   detection](detect_captive_portals).
 
 - Time sync using NTP, unsafe but good enough as a first approximation
@@ -461,48 +460,45 @@ We can display some progress of the connection on each screen:
 
 ![autoconfig_-_internet_access](network_connection/autoconfig_-_internet_access.png)
 
-Image on the left pane
-----------------------
+### Image on the left pane
 
 We change the image on the left pane to avoid confusion with the term
 "bridges".
 
-![autoconfig](network_configuration/autoconfig.png)
+![autoconfig](network_connection/autoconfig.png)
+
+### Autoconfig with bridge option
 
-Behind captive portal
----------------------
+![autoconfig_-_bridges](network_connection/autoconfig_-_bridges.png)
+
+### Captive portal
 
 ![tor_connection_-_everything](network_connection/tor_connection_-_everything.png)
 
 ![autoconfig_-_captive_portal](network_connection/autoconfig_-_captive_portal.png)
 
-Connecting to Tor without bridges
----------------------------------
+### Connecting to Tor without bridges
 
 ![autoconfig_-_direct](network_connection/autoconfig_-_direct.png)
 
-Connecting to Tor with default bridges
---------------------------------------
+### Connecting to Tor with default bridges
 
 ![autoconfig_-_default](network_connection/autoconfig_-_default.png)
 
-Connecting to Tor with custom bridges
--------------------------------------
+### Connecting to Tor with custom bridges
 
 ![autoconfig_-_custom](network_connection/autoconfig_-_custom.png)
 
-Success
--------
+### Success
 
 ![tor_connection_-_success](network_connection/tor_connection_-_success.png)
 
-Reset Tor connection
---------------------
+### Reset Tor connection
 
 ![tor_connection_-_reset](network_connection/tor_connection_-_reset.png)
 
 Hide Tor
-========
+--------
 
 If the user chooses to hide Tor, we don't automate anything nor use
 default bridges.
@@ -510,16 +506,14 @@ default bridges.
 As a consequence, we cannot display the same progress indicator like we
 do for autoconfig.
 
-Image on the left pane
-----------------------
+### Image on the left pane
 
 We change the image on the left pane to avoid confusion with the term
 "bridges".
 
-![hide](network_configuration/hide.png)
+![hide](network_connection/hide.png)
 
-Bridges
--------
+### Bridges
 
 We always use bridges:
 
@@ -527,41 +521,49 @@ We always use bridges:
 
 Clicking **Cancel** goes back to the million dollar question.
 
-Persistent bridges
-------------------
+### Moat
 
-Persistent bridges are proposed by default and the label is changed to
-**Use** instead of **Type in**:
-
-![hide_-_persistent](network_connection/hide_-_persistent.png)
-
-Moat
-----
+Starting Moat:
 
 ![moat_-_start](network_connection/moat_-_start.png)
 
+Captcha:
+
 ![moat_-_captcha](network_connection/moat_-_captcha.png)
 
+Success:
+
 ![moat_-_success](network_connection/moat_-_success.png)
 
+Help to saving persistent bridges:
+
+![persistent_storage_-_help](network_connection/persistent_storage_-_help.png)
+
+Failure:
+
 ![moat_-_failure](network_connection/moat_-_failure.png)
 
-Connecting to Tor
------------------
+### Persistent bridges
+
+Persistent bridges are proposed by default and the label is changed to
+**Use** instead of **Type in**:
+
+![hide_-_persistent](network_connection/hide_-_persistent.png)
+
+### Connecting to Tor
 
 ![hide_-_connecting](network_connection/hide_-_connecting.png)
 
-Failure
--------
+### Failure
 
-### Time sync
+- Time sync
 
   If we have IP connectivity to the bridge but cannot connect to Tor, it's
   probably a time sync issue:
 
   ![hide_-_time](network_connection/hide_-_time.png)
 
-### Captive portal or proxy
+- Captive portal or proxy
 
   If we don't even have IP connectivity to the bridge, we might be behind
   a proxy or captive portal.
@@ -569,19 +571,17 @@ a proxy or captive portal.
   ![hide_-_failure](network_connection/hide_-_failure.png)
 
 Persistent Storage
-==================
+------------------
 
 Mention Tor bridges in the first screen of the Persistent Storage
 settings:
 
-![persistent_storage_-_discovery](network_connection/persistent_storage_-_discovery.png)
+![persistent_storage_-_discovery](Persistent-Storage-redesign/welcome_-_discovery.png)
 
 When creating the Persistent Storage coming from a switch that turns on
 persistent bridges, for example, display a button to skip configuring
 all the features of the Persistent Storage:
 
-![persistent_storage_-_help](network_connection/persistent_storage_-_help.png)
-
 ![persistent_storage_-_create](network_connection/persistent_storage_-_create.png)
 
 ![persistent_storage_-_only_save](network_connection/persistent_storage_-_only_save.png)
@@ -591,7 +591,7 @@ Network features:
 ![persistent_storage_-_network](network_connection/persistent_storage_-_network.png)
 
 Welcome Screen
-==============
+--------------
 
 Offline Mode:
 
@@ -602,7 +602,7 @@ Change management to replace the Network Configuration setting:
 ![welcome_screen_-_change_management](network_connection/welcome_screen_-_change_management.png)
 
 Tor Browser
-===========
+-----------
 
 When Tor is not connected: