Skip to content

Commit 1f9db71

Browse files
committed
More copy review from Corry, moved voice and tone back to style
1 parent da8b851 commit 1f9db71

File tree

1 file changed

+4
-7
lines changed

1 file changed

+4
-7
lines changed

source/style-guide/style/links-and-cross-references.txt

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -70,12 +70,10 @@ Avoid Inline References in Tutorials
7070
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7171

7272
Avoid adding inline textual references in tutorials or stepped procedures.
73-
7473
If users follow inline references while in the middle of a procedure,
7574
they might have difficulty navigating back and reorienting themselves
76-
with their current step.
77-
78-
Inline textual references may be appropriate for more reference-heavy pages.
75+
with their current step. Inline textual references may be appropriate
76+
for more reference-heavy pages.
7977

8078
Minimize Repeated Links
8179
~~~~~~~~~~~~~~~~~~~~~~~
@@ -85,9 +83,8 @@ Minimize Repeated Links
8583
You may link to the same target multiple times on the same page, but
8684
think carefully about whether it's absolutely necessary. For example,
8785
if a page is particularly long and contains many sections, then it might
88-
be helpful to link to a target an additional time or two. Users may
89-
immediately navigate to a section far down on a page and miss the initial
90-
reference.
86+
help to link to a target an additional time or two. Users might immediately
87+
navigate to a section far down on a page and miss the initial reference.
9188

9289
- If you add repeated links, use the same style for each link.
9390
Consider whether a plaintext link or a monospace link is appropriate.

0 commit comments

Comments
 (0)