Clarify that links to tutorials don't need a /tutorials/ prefix (#835)

* Clarify that links to tutorials don't need a /tutorials/ prefix

* Explain that articles match first in tutorial file name collisions

rdar://124124417

Author: d-ronnqvist

Sources/docc/DocCDocumentation.docc/linking-to-symbols-and-other-content.md

@@ -166,10 +166,10 @@ path in either source language.
 ### Navigate to an Article
 
 To add a link to an article, use the less-than symbol (`<`), the `doc` keyword, 
-a colon (`:`), the name of the article, and a greater-than symbol 
-(`>`). Don't include the article's file extension in the name. 
+a colon (`:`), the article's file name without file extension, and a greater-than symbol 
+(`>`).  
 
-```
+```markdown
 <doc:GettingStarted>
 ```
 
@@ -181,11 +181,17 @@ For example, the link to an article with a file name "Getting Started.md" is
 ```
 
 When DocC resolves the link, it uses the article's page title as the link's 
-text, and the article's filename as the link's URL. Links to tutorials follow 
-the same format, except you must add the `/tutorials/` prefix to the path: 
+text. Links to tutorials follow the same format. 
 
+```markdown
+<doc:SlothCreator>
 ```
-<doc:/tutorials/SlothCreator>
+
+If you have an article file and a tutorial file with the same base name, DocC will resolve the `<doc:BaseName>` link to the article. To refer to the tutorial instead you can add a leading `tutorials` component to the path, with or without a leading slash: 
+
+```markdown
+<doc:tutorials/BaseName>
+<doc:/tutorials/BaseName>
 ```
 
 > Tip: You can also link to symbols using the `<doc:>` syntax. Just insert the 
@@ -238,4 +244,4 @@ add the link's URL within the parentheses.
 [Apple](https://www.apple.com)
 ```
 
-<!-- Copyright (c) 2023 Apple Inc and the Swift Project authors. All Rights Reserved. -->
+<!-- Copyright (c) 2023-2024 Apple Inc and the Swift Project authors. All Rights Reserved. -->