docs: Create and use *Administrator only feature* macro.

templates/zerver/help/add-a-custom-linkification-filter.md

@@ -1,8 +1,9 @@
 # Add a custom linkification filter
 
-If you are an administrator of a Zulip organization, you can add custom
-linkification filters to your organization that automatically turn phrases in
-messages into links to other pages.
+{!admin-only.md!}
+
+You can add custom linkification filters to your organization that
+automatically turn phrases in messages into links to other pages.
 
 {!go-to-the.md!} [Filter Settings](/#administration/filter-settings)
 {!admin.md!}

templates/zerver/help/add-custom-emoji.md

@@ -1,7 +1,7 @@
 # Add custom emoji
 
-If you are an administrator of a Zulip organization, you can add
-custom emojis to your organization for other members to use.
+If enabled by your Zulip organization administrator, you can add custom
+emojis to your organization for other members to use.
 
 {!go-to-the.md!} [Emoji Settings](/#administration/emoji-settings)
 {!admin.md!}

templates/zerver/help/allow-anyone-to-join-without-an-invitation.md

@@ -1,5 +1,7 @@
 # Allow anyone to join without an invitation
 
+{!admin-only.md!}
+
 By default, new users can join a Zulip organization with or without an email
 invitation.
 

templates/zerver/help/change-a-users-name.md

@@ -1,9 +1,10 @@
 # Change a user's name
-An administrator can change the name of another user. Ordinary users can
-[change their own names](/help/change-your-name), but administrators can change
-users' names when users are unavailable.
 
-{!follow-steps.md!}  change the name of a user using an administrator account.
+{!admin-only.md!}
+
+Ordinary users can [change their own names](/help/change-your-name), but
+administrators can change users' names when users are
+unavailable. {!follow-steps.md!} change the name of a user.
 
 {!go-to-the.md!} [Users](/#administration/user-list-admin)
 {!admin.md!}

templates/zerver/help/change-the-default-language-for-your-organization.md

@@ -1,7 +1,8 @@
 # Change the default language
 
-If you are an administrator of a Zulip organization, you can change the default
-language of your organization by following the following steps.
+{!admin-only.md!}
+
+{!follow-steps.md!} change the default language of your organization.
 
 {!go-to-the.md!} [Organization Settings](/#administration/organization-settings)
 {!admin.md!}

templates/zerver/help/change-the-stream-description.md

@@ -1,7 +1,9 @@
 # Change the stream description
 
-If you are an administrator of a Zulip organization, you can change the
-description of any stream in your organization.
+{!admin-only.md!}
+
+{!follow-steps.md!} change the description of any stream in your
+organization.
 
 {!subscriptions.md!}
 {!filter-streams.md!}

templates/zerver/help/change-who-can-join-a-stream.md

@@ -1,7 +1,9 @@
 # Change the accessibility of a stream
 
-If you are a Zulip organization administrator, you can change who can join your
-stream by changing the stream's accessibility.
+{!admin-only.md!}
+
+{!follow-steps.md!} change who can join your stream by changing the stream's
+accessibility.
 
 Please note that any users that were previously subscribed to the stream will
 remain subscribed to the stream after you change the stream's accessibility.

templates/zerver/help/change-your-organizations-name.md

@@ -1,8 +1,8 @@
 # Change your organization's name
-Only an administrator can change the name of the organization.
 
-{!follow-steps.md!} change the name of the organization
-using an administrator account:
+{!admin-only.md!}
+
+{!follow-steps.md!} change the name of your organization.
 
 {!go-to-the.md!} [Organization Settings](/#administration/organization-settings)
 {!admin.md!}

templates/zerver/help/deactivate-or-reactivate-a-bot.md

@@ -1,7 +1,13 @@
 # Deactivate or reactivate a bot
 
-Zulip organization administrators have the ability to deactivate or reactivate any bots
-in their organization.
+{!admin-only.md!}
+
+{!follow-steps.md!} deactivate or reactivate any bots
+in your organization.
+
+!!! tip ""
+    You can manage your own bots or integrations on the
+    [Your bots](/#settings/your-bots) {!settings.md!}
 
 ## Deactivate a bot
 

templates/zerver/help/deactivate-or-reactivate-a-user.md

@@ -1,7 +1,9 @@
 # Deactivate or reactivate a user
 
-Zulip organization administrators have the ability to deactivate or reactivate any
-user's account in their organization.
+{!admin-only.md!}
+
+{!follow-steps.md!} deactivate or reactivate any user's account in your
+organization.
 
 ## Deactivate a user
 

templates/zerver/help/delete-a-stream.md

@@ -1,5 +1,7 @@
 # Delete a stream
 
+{!admin-only.md!}
+
 In Zulip, most of the stream administration is done on the subscription page.
 However, Zulip organization administrators must use their administration panels
 to delete streams.

templates/zerver/help/edit-administrator-settings.md

@@ -1,5 +1,7 @@
 # Edit [Administrator](/#administration) Settings
 
+{!admin-only.md!}
+
 1. Click the cog (<i class="icon-vector-cog"></i>) icon in the top right corner.
 2. From the dropdown menu, choose the **Administration** option.
 

templates/zerver/help/include/admin-only.md

@@ -0,0 +1,2 @@
+!!! warn ""
+    **Note:** This feature can only be controlled by organization administrators.

templates/zerver/help/make-a-user-an-administrator.md

@@ -1,9 +1,10 @@
 # Make a user an administrator
 
+{!admin-only.md!}
+
 By default, everyone in an organization is a user; this limits them from
 modifying organization-wide settings, such as changing the organization name,
-activating or deactivating users, deleting streams, etc. Zulip organization
-administrators can give a user administrative rights. {!follow-steps.md!}
+activating or deactivating users, deleting streams, etc. {!follow-steps.md!}
 give any user in your organization administrative rights.
 
 {!go-to-the.md!} [Users](/#administration/user-list-admin)

templates/zerver/help/only-allow-admins-to-create-new-streams-feature.md

@@ -1,6 +1,8 @@
 # Only allow admins to create new streams
 
-If you are a Zulip organization administrator, you can enable a setting that
+{!admin-only.md!}
+
+By default, any user can create new streams. You can enable a setting that
 only allows administrators to create new streams in the organization.
 
 {!go-to-the.md!} [Organization settings](/#administration/organization-settings)

templates/zerver/help/only-allow-admins-to-invite-new-users.md

@@ -1,6 +1,10 @@
 # Only allow admins to invite new users
-If you are an administrator, you can change the setting to only allow administrators
-to invite new users.
+
+{!admin-only.md!}
+
+By default, any user in your Zulip organization can invite new users. You
+can change your organization's settings to only allow administrators to
+invite new users.
 
 {!go-to-the.md!} [Organization settings](/#administration/organization-settings)
 {!admin.md!}

templates/zerver/help/remove-someone-from-a-stream.md

@@ -1,7 +1,9 @@
 # Remove someone from a stream
 
-As an administrator, Zulip allows you to remove users from streams to help
-manage your Zulip team.
+{!admin-only.md!}
+
+Zulip allows you to remove users from streams to help manage your Zulip
+team.
 
 {!subscriptions.md!}
 {!filter-streams.md!}

templates/zerver/help/rename-a-stream.md

@@ -1,7 +1,8 @@
 # Rename a stream
 
-If you are an administrator of a Zulip organization, you can rename existing
-streams by following the following steps.
+{!admin-only.md!}
+
+{!follow-steps.md!} rename existing streams in your organization.
 
 {!subscriptions.md!}
 {!filter-streams.md!}

templates/zerver/help/restrict-editing-of-old-messages-and-topics.md

@@ -1,9 +1,10 @@
 # Restrict editing of old messages and topics
 
-If you are an administrator of a Zulip organization, you can easily change the
-time limit that your organization's users have to change their messages after sending
-them. Alternatively, you can choose to disable message editing for your organization
-users.
+{!admin-only.md!}
+
+You can easily change the time limit that your organization's users have to
+change their messages after sending them. Alternatively, you can choose to
+disable message editing for your organization users.
 
 {!go-to-the.md!} [Organization Settings](/#administration/organization-settings)
 {!admin.md!}

templates/zerver/help/restrict-user-email-addresses-to-certain-domains.md

@@ -1,8 +1,11 @@
 # Restrict user email addresses to certain domains
 
-We allow administrators to block new users from signing up who are not in
- the organization. The administrator can accomplish this by restricting
- users to have email addresses only from the organization's domains.
+{!admin-only.md!}
+
+Zulip allows organization administrators to block new users from signing up
+who are not in their organization. The administrator can accomplish this by
+restricting users to have email addresses only from the organization's
+domains.
 
 {!go-to-the.md!} [Organization settings](/#administration/)
 {!admin.md!}

templates/zerver/help/set-default-streams-for-new-users.md

@@ -1,8 +1,9 @@
 # Set default streams for new users
 
-If you are an administrator of a Zulip organization, you can set the default
-streams that new users are automatically subscribed to by following the
-following steps.
+{!admin-only.md!}
+
+{!follow-steps.md!} set the default streams that new users are automatically
+subscribed to.
 
 {!go-to-the.md!} [Default streams](/#administration/default-streams-list)
 {!admin.md!}

templates/zerver/help/view-all-bots-in-your-organization.md

@@ -1,8 +1,8 @@
 # View all bots in your organization
 
-If you are an administrator of a Zulip organization, you can view a list of all
-bots in your organization, active or deactivated alike, by visiting the
-[Bots](/#administration/bot-list-admin)
-{!admin.md!}
+{!admin-only.md!}
+
+You can view a list of all bots in your organization, active or deactivated
+alike, by visiting the [Bots](/#administration/bot-list-admin) {!admin.md!}
 You can [deactivate or reactivate](/help/deactivate-or-reactivate-a-bot) any
 bots in your organization from this panel.