Merge pull request #1995 from Matejkob/attribite-nodes-in-docc-index

Add attributes section to docc index

Author: ahoppen

CodeGeneration/Sources/generate-swiftsyntax/templates/swiftsyntax/SwiftSyntaxDoccIndex.swift

@@ -59,6 +59,8 @@ let nodesSections: String = {
       })
   )
 
+  addSection(heading: "Attributes", types: ATTRIBUTE_NODES.map(\.kind.syntaxType.description).sorted())
+
   addSection(heading: "Miscellaneous Syntax", types: SYNTAX_NODES.map(\.kind.syntaxType.description).filter({ !handledSyntaxTypes.contains($0) }))
 
   addSection(heading: "Traits", types: TRAITS.map { "\($0.protocolName)" })

Sources/SwiftSyntax/Documentation.docc/generated/SwiftSyntax.md

@@ -303,38 +303,61 @@ These articles are intended for developers wishing to contribute to SwiftSyntax
 - <doc:SwiftSyntax/YieldedExpressionListSyntax>
 - <doc:SwiftSyntax/YieldedExpressionSyntax>
 
+### Attributes
+
+- <doc:SwiftSyntax/AttributeListSyntax>
+- <doc:SwiftSyntax/AttributeSyntax>
+- <doc:SwiftSyntax/BackDeployedAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/ConventionAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/ConventionWitnessMethodAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/DerivativeAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/DifferentiabilityArgumentListSyntax>
+- <doc:SwiftSyntax/DifferentiabilityArgumentSyntax>
+- <doc:SwiftSyntax/DifferentiabilityArgumentsSyntax>
+- <doc:SwiftSyntax/DifferentiabilityWithRespectToArgumentSyntax>
+- <doc:SwiftSyntax/DifferentiableAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/DocumentationAttributeArgumentListSyntax>
+- <doc:SwiftSyntax/DocumentationAttributeArgumentSyntax>
+- <doc:SwiftSyntax/DynamicReplacementAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/EffectsAttributeArgumentListSyntax>
+- <doc:SwiftSyntax/ExposeAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/ImplementsAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/LabeledSpecializeArgumentSyntax>
+- <doc:SwiftSyntax/ObjCSelectorPieceListSyntax>
+- <doc:SwiftSyntax/ObjCSelectorPieceSyntax>
+- <doc:SwiftSyntax/OpaqueReturnTypeOfAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/OriginallyDefinedInAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/PlatformVersionItemListSyntax>
+- <doc:SwiftSyntax/PlatformVersionItemSyntax>
+- <doc:SwiftSyntax/QualifiedDeclNameSyntax>
+- <doc:SwiftSyntax/SpecializeAttributeArgumentListSyntax>
+- <doc:SwiftSyntax/SpecializeAvailabilityArgumentSyntax>
+- <doc:SwiftSyntax/SpecializeTargetFunctionArgumentSyntax>
+- <doc:SwiftSyntax/UnavailableFromAsyncAttributeArgumentsSyntax>
+- <doc:SwiftSyntax/UnderscorePrivateAttributeArgumentsSyntax>
+
 ### Miscellaneous Syntax
 
 - <doc:SwiftSyntax/AccessorBlockSyntax>
 - <doc:SwiftSyntax/AccessorEffectSpecifiersSyntax>
 - <doc:SwiftSyntax/AccessorParametersSyntax>
 - <doc:SwiftSyntax/AvailabilityConditionSyntax>
 - <doc:SwiftSyntax/AvailabilityLabeledArgumentSyntax>
-- <doc:SwiftSyntax/BackDeployedAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/ClosureCaptureClauseSyntax>
 - <doc:SwiftSyntax/ClosureCaptureSpecifierSyntax>
 - <doc:SwiftSyntax/ClosureParameterClauseSyntax>
 - <doc:SwiftSyntax/ClosureSignatureSyntax>
 - <doc:SwiftSyntax/CodeBlockSyntax>
 - <doc:SwiftSyntax/ConformanceRequirementSyntax>
-- <doc:SwiftSyntax/ConventionAttributeArgumentsSyntax>
-- <doc:SwiftSyntax/ConventionWitnessMethodAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/DeclModifierDetailSyntax>
 - <doc:SwiftSyntax/DeclNameArgumentsSyntax>
 - <doc:SwiftSyntax/DeinitializerEffectSpecifiersSyntax>
-- <doc:SwiftSyntax/DerivativeAttributeArgumentsSyntax>
-- <doc:SwiftSyntax/DifferentiabilityArgumentsSyntax>
-- <doc:SwiftSyntax/DifferentiabilityWithRespectToArgumentSyntax>
-- <doc:SwiftSyntax/DifferentiableAttributeArgumentsSyntax>
-- <doc:SwiftSyntax/DynamicReplacementAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/EnumCaseParameterClauseSyntax>
-- <doc:SwiftSyntax/ExposeAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/FunctionEffectSpecifiersSyntax>
 - <doc:SwiftSyntax/FunctionParameterClauseSyntax>
 - <doc:SwiftSyntax/FunctionSignatureSyntax>
 - <doc:SwiftSyntax/GenericArgumentClauseSyntax>
 - <doc:SwiftSyntax/GenericParameterClauseSyntax>
-- <doc:SwiftSyntax/ImplementsAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/InheritanceClauseSyntax>
 - <doc:SwiftSyntax/InitializerClauseSyntax>
 - <doc:SwiftSyntax/KeyPathOptionalComponentSyntax>
@@ -344,14 +367,11 @@ These articles are intended for developers wishing to contribute to SwiftSyntax
 - <doc:SwiftSyntax/MatchingPatternConditionSyntax>
 - <doc:SwiftSyntax/MemberBlockSyntax>
 - <doc:SwiftSyntax/MissingSyntax>
-- <doc:SwiftSyntax/OpaqueReturnTypeOfAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/OperatorPrecedenceAndTypesSyntax>
 - <doc:SwiftSyntax/OptionalBindingConditionSyntax>
-- <doc:SwiftSyntax/OriginallyDefinedInAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/PlatformVersionSyntax>
 - <doc:SwiftSyntax/PoundSourceLocationArgumentsSyntax>
 - <doc:SwiftSyntax/PrimaryAssociatedTypeClauseSyntax>
-- <doc:SwiftSyntax/QualifiedDeclNameSyntax>
 - <doc:SwiftSyntax/ReturnClauseSyntax>
 - <doc:SwiftSyntax/SameTypeRequirementSyntax>
 - <doc:SwiftSyntax/SourceFileSyntax>
@@ -360,8 +380,6 @@ These articles are intended for developers wishing to contribute to SwiftSyntax
 - <doc:SwiftSyntax/TypeAnnotationSyntax>
 - <doc:SwiftSyntax/TypeEffectSpecifiersSyntax>
 - <doc:SwiftSyntax/TypeInitializerClauseSyntax>
-- <doc:SwiftSyntax/UnavailableFromAsyncAttributeArgumentsSyntax>
-- <doc:SwiftSyntax/UnderscorePrivateAttributeArgumentsSyntax>
 - <doc:SwiftSyntax/VersionTupleSyntax>
 - <doc:SwiftSyntax/WhereClauseSyntax>
 - <doc:SwiftSyntax/YieldedExpressionsClauseSyntax>