Merge pull request #1094 from CodaFi/subdoxastic

Author: CodaFi

Documentation/README.md

@@ -72,11 +72,20 @@ Replace `<#Specify Release tag#>` by the version of SwiftSyntax that you want to
 
 ## Documentation
 
-Documentation can be found in the following places:
-- For the parser: [Sources/SwiftParser/SwiftParser.docc](Sources/SwiftParser/SwiftParser.docc) 
-  - You can either directly view this documentation on GitHub or build a documentation bundle by opening the project in Xcode and clicking Product -> Build Documentation
-- General documentation: [Documentation](Documentation) 
-- Examples of using SwiftSyntax: [Examples](Examples).
+SwiftSyntax uses [DocC](https://developer.apple.com/documentation/docc) bundles
+for its documentation. To view rendered documentation in Xcode, open the 
+SwiftSyntax package and select
+
+```
+Product > Build Documentation
+``` 
+
+Associated articles are written in markdown, and can be viewed in a browser, 
+text editor, or IDE.
+
+- [SwiftSyntax](Sources/SwiftSyntax/Documentation.docc)
+- [SwiftParser](Sources/SwiftParser/SwiftParser.docc)
+- [SwiftOperators](Sources/SwiftOperators/SwiftOperators.docc)
 
 ## Contributing
 

Documentation/SwiftParser.md

@@ -24,6 +24,7 @@ allows Swift tools to parse, inspect, generate, and transform Swift source code.
 ### Articles
 
 - <doc:ChangingSwiftSyntax>
+- <doc:Create-SwiftSyntax-Release>
 
 ### Syntax
 

README.md

@@ -17,6 +17,7 @@ allows Swift tools to parse, inspect, generate, and transform Swift source code.
 ### Articles
 
 - <doc:ChangingSwiftSyntax>
+- <doc:Create-SwiftSyntax-Release>
 
 ### Syntax