Curate (organize layout) and remove DocC warnings for PackageDescription (#8718)

### Motivation:

Cleanup of organization after growth and evolution of the API over the
past few years

### Modifications:

- added curation to organize methods and properties, pushing deprecated
items below
- removed extensions no longer needed (and no longer resolved)
- resolved warnings for disambiguation reported by DocC
- re-organizing package dependencies into groups by URL, registry, or
local to break up the large list
- added an extension pages for Version and SwiftLanguageMode to provide
curation for those symbols

### Result:

- deprecated methods moved down, frequently used methods brought up and
large lists broken up by usage pattern to make them more accessible.

Author: heckj

Sources/PackageDescription/PackageDescription.docc/Curation/CLanguageStandard.md

@@ -37,8 +37,3 @@
 ### Creating a Value
 
 - ``init(rawValue:)``
-
-### Accessing the Raw Value
-
-- ``rawValue-swift.property``
-- ``RawValue-swift.typealias``

Sources/PackageDescription/PackageDescription.docc/Curation/CXXLanguageStandard.md

@@ -33,8 +33,3 @@
 ### Creating a Value
 
 - ``init(rawValue:)``
-
-### Accessing the Raw Value
-
-- ``rawValue-swift.property``
-- ``RawValue-swift.typealias``

Sources/PackageDescription/PackageDescription.docc/Curation/Dependency.md

@@ -2,55 +2,64 @@
 
 ## Topics
 
-### Creating a Package Dependency
+### Creating a package dependency from a URL
 
-- ``package(name:path:)``
-- ``package(name:path:traits:)``
-- ``package(path:)``
-- ``package(path:traits:)``
 - ``package(url:from:)``
+- ``package(url:from:traits:)``
 - ``package(url:_:)-2ys47``
+- ``package(url:_:traits:)-(_,Range<Version>,_)``
 - ``package(url:_:)-1r6rc``
+- ``package(url:_:traits:)-(_,ClosedRange<Version>,_)``
 - ``package(url:branch:)``
+- ``package(url:branch:traits:)``
 - ``package(url:revision:)``
+- ``package(url:revision:traits:)``
 - ``package(url:exact:)``
 - ``package(url:exact:traits:)``
-- ``package(url:_:traits:)-(_,Range<Version>,_)``
-- ``package(url:_:traits:)-(_,ClosedRange<Version>,_)``
-- ``package(url:branch:traits:)``
-- ``package(url:from:traits:)``
-- ``package(url:revision:traits:)``
+
+### Creating a package dependency from a registry
+
+- ``package(id:from:)``
+- ``package(id:from:traits:)``
 - ``package(id:_:)-(_,Range<Version>)``
-- ``package(id:_:)-(_,ClosedRange<Version>)``
 - ``package(id:_:traits:)-(_,Range<Version>,_)``
+- ``package(id:_:)-(_,ClosedRange<Version>)``
 - ``package(id:_:traits:)-(_,ClosedRange<Version>,_)``
 - ``package(id:exact:)``
 - ``package(id:exact:traits:)``
-- ``package(id:from:)``
-- ``package(id:from:traits:)``
-- ``package(name:url:_:)-(String?,_,_)``
-- ``package(name:url:_:)-(_,_,Range<Version>)``
-- ``package(name:url:_:)-(_,_,ClosedRange<Version>)``
-- ``package(name:url:branch:)``
-- ``package(name:url:from:)``
-- ``package(name:url:revision:)``
-- ``package(url:_:)-(_,Package.Dependency.Requirement)``
-- ``name``
-- ``url``
+
+### Creating a local dependency
+
+- ``package(name:path:)``
+- ``package(name:path:traits:)``
+- ``package(path:)``
+- ``package(path:traits:)``
 
 ### Declaring Requirements
 
-- ``requirement-swift.property``
-- ``Requirement-swift.enum``
 - ``traits``
 - ``Trait``
 - ``RegistryRequirement``
 - ``SourceControlRequirement``
+- ``requirement-swift.property``
+- ``Requirement-swift.enum``
 
 ### Describing a Package Dependency
 
-- ``name``
-- ``url``
 - ``kind-swift.property``
 - ``Kind``
 - ``Version``
+- ``name``
+- ``url``
+
+### Deprecated methods
+
+- ``package(name:url:_:)-(String?,_,_)``
+- ``package(name:url:_:)-(_,_,Range<Version>)``
+- ``package(name:url:_:)-(_,_,ClosedRange<Version>)``
+- ``package(name:url:branch:)``
+- ``package(name:url:from:)``
+- ``package(name:url:revision:)``
+- ``package(url:_:)-(_,Package.Dependency.Requirement)``
+- ``name``
+- ``url``

Sources/PackageDescription/PackageDescription.docc/Curation/Extensions/LanguageTg-ExtendedGraphemeClusterLiteralType.md

@@ -19,8 +19,3 @@
 ### Creating a Value
 
 - <doc:/documentation/PackageDescription/Product/Library/LibraryType/init(rawValue:)>
-
-### Accessing the Raw Value
-
-- ``rawValue-swift.property``
-- ``RawValue-swift.typealias``

Sources/PackageDescription/PackageDescription.docc/Curation/Extensions/Library-LibraryType-rawValue.md

@@ -22,10 +22,3 @@
 ### Operator Functions
 
 - <doc:/documentation/PackageDescription/LanguageTag/!=(_:_:)>
-
-### Identifying Related Types
-
-- ``LanguageTag/ExtendedGraphemeClusterLiteralType``
-- ``LanguageTag/RawValue-swift.typealias``
-- ``LanguageTag/StringLiteralType``
-- ``LanguageTag/UnicodeScalarLiteralType``

Sources/PackageDescription/PackageDescription.docc/Curation/Extensions/Library-LibraryType.md

@@ -56,11 +56,10 @@
 ### Declaring Supported Languages
 
 - ``SwiftLanguageMode``
-- ``SwiftVersion``
 - ``CLanguageStandard``
 - ``CXXLanguageStandard``
 - ``Package/swiftLanguageModes``
-- ``Package/swiftLanguageVersions``
 - ``Package/cLanguageStandard``
 - ``Package/cxxLanguageStandard``
-
+- ``SwiftVersion``
+- ``Package/swiftLanguageVersions``

Sources/PackageDescription/PackageDescription.docc/Curation/LanguageTag.md

@@ -19,8 +19,3 @@
 ### Creating a Value
 
 - ``init(rawValue:)``
-
-### Accessing the Raw Value
-
-- ``rawValue-swift.property``
-- ``RawValue-swift.typealias``

Sources/PackageDescription/PackageDescription.docc/Curation/Package.md

@@ -0,0 +1,13 @@
+# ``PackageDescription/SwiftLanguageMode``
+
+## Topics
+
+### Swift Language Modes
+
+- ``v6``
+- ``v5``
+- ``v4_2``
+- ``v4``
+- ``version(_:)``
+- ``v3``
+