help-docs: Improve "Logging in" and "Switching between organizations".

Improves step-by-step instructions for Desktop users by directing
users to the relevant items in the left sidebar or top menu bar
without using an obscure keyboard shortcut.

Adds tip macro with instructions for toggling the app's left sidebar
via the top menu bar.

Moves the proxy settings and custom certificate info into a warning
block instead of the main instructions flow given they are rarely
needed for Logging in.

Adds a Related Articles section to "Switching between organizations"
so that users can access the information for setting an organization
profile picture from there instead of an oddly placed warning block.

Also adds links to "Logging in", "Logging out", and "Deactivate your
account", and lists them in each other's Related articles sections.
This commit is contained in:
David Rosa 2022-07-14 21:02:26 -04:00 committed by Tim Abbott
parent 26b51d9393
commit 0f7742ec4d
4 changed files with 37 additions and 19 deletions

View File

@ -37,5 +37,7 @@
## Related articles
You may also be interested in
[deactivating an organization](/help/deactivate-your-organization).
* [Logging in](logging-in)
* [Logging out](logging-out)
* [Switching between organizations](switching-between-organizations)
* [Deactivate your organization](/help/deactivate-your-organization)

View File

@ -0,0 +1,4 @@
!!! tip ""
To show or hide the **organizations sidebar** on the left, select
**Toggle Sidebar** from the **View** menu in the top menu bar.

View File

@ -13,29 +13,33 @@ how you signed up. E.g. if you originally signed up using your Google
account, you can later log in using GitHub, as long as your Google account
and GitHub account use the same email address.
### Log in to a Zulip organization for the first time
## Log in to a Zulip organization for the first time
{start_tabs}
{tab|web}
1. Go to your organization's **Zulip URL**.
1. Go to the Zulip URL of the organization.
1. Follow the on-screen instructions.
{tab|desktop}
1. Open the **left sidebar** (`Ctrl` + `Shift` + `s`).
!!! warn ""
If you are having trouble connecting, you may need to set your
[proxy settings](/help/connect-through-a-proxy) or add a
[custom certificate](/help/custom-certificates).
1. Set your [proxy settings](/help/connect-through-a-proxy) or add a
[custom certificate](/help/custom-certificates) if needed (rare).
1. Click the **plus** (<i class="fa fa-plus"></i>) icon in the
**organizations sidebar** on the left. You can also select **Add Organization**
from the **Zulip** menu in the top menu bar.
1. Click the **plus** (+) icon.
1. Enter your Zulip URL, and click **Connect**.
1. Enter the Zulip URL of the organization, and click **Connect**.
1. Follow the on-screen instructions.
{!desktop-toggle-sidebar-tip.md!}
{tab|mobile}
{!mobile-profile-menu.md!}
@ -44,7 +48,7 @@ and GitHub account use the same email address.
1. Tap **Add new account**.
1. Enter your Zulip URL, and tap **Enter**.
1. Enter the Zulip URL of the organization, and tap **Enter**.
1. Follow the on-screen instructions.
@ -80,3 +84,9 @@ in via email/password, you can
You can [reset your password](/help/change-your-password). This requires
access to the email address you currently have on file. We recommend
[keeping your email address up to date](change-your-email-address).
## Related articles
* [Logging out](logging-out)
* [Switching between organizations](switching-between-organizations)
* [Deactivate your account](deactivate-your-account)

View File

@ -12,15 +12,10 @@ just switch tabs.
{tab|desktop}
1. Open the **left sidebar** (`Ctrl` + `Shift` + `s`).
1. Click on a logo in the **organizations sidebar** on the left, or choose
an organization from the **Window** menu in the top menu bar.
1. Click on your organization's profile picture.
!!! warn ""
You can ask your organization administrator to
[set an organization profile picture](/help/create-your-organization-profile)
if they haven't already.
{!desktop-toggle-sidebar-tip.md!}
{tab|mobile}
@ -31,3 +26,10 @@ just switch tabs.
1. Tap on the desired Zulip organization.
{end_tabs}
## Related articles
* [Logging in](logging-in)
* [Logging out](logging-out)
* [Deactivate your account](deactivate-your-account)
* [Create your organization profile](create-your-organization-profile)