Merge pull request #40918 from vsanna

* pr/40918:
  Warn in the documentation that spring.profiles.group can only be used in non-profile-specific documents

Closes gh-40918

Author: mhalbritter

spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/profiles.adoc

@@ -31,8 +31,8 @@ The name of the default profile is `default` and it can be tuned using the confi
 	    default: "none"
 ----
 
-`spring.profiles.active` and `spring.profiles.default` can only be used in non-profile specific documents.
-This means they cannot be included in <<features#features.external-config.files.profile-specific,profile specific files>> or <<features#features.external-config.files.activation-properties,documents activated>> by `spring.config.activate.on-profile`.
+`spring.profiles.active` and `spring.profiles.default` can only be used in non-profile-specific documents.
+This means they cannot be included in xref:features/external-config.adoc#features.external-config.files.profile-specific[profile specific files] or xref:features/external-config.adoc#features.external-config.files.activation-properties[documents activated] by `spring.config.activate.on-profile`.
 
 For example, the second document configuration is invalid:
 
@@ -75,8 +75,8 @@ For example, when an application with the following properties is run, the commo
 	      - "local"
 ----
 
-WARNING: Similar to `spring.profiles.active`, `spring.profiles.include` can only be used in non-profile specific documents.
-This means it cannot be included in <<features#features.external-config.files.profile-specific,profile specific files>> or <<features#features.external-config.files.activation-properties,documents activated>> by `spring.config.activate.on-profile`.
+WARNING: Similar to `spring.profiles.active`, `spring.profiles.include` can only be used in non-profile-specific documents.
+This means it cannot be included in xref:features/external-config.adoc#features.external-config.files.profile-specific[profile specific files] or xref:features/external-config.adoc#features.external-config.files.activation-properties[documents activated] by `spring.config.activate.on-profile`.
 
 Profile groups, which are described in the <<features#features.profiles.groups,next section>> can also be used to add active profiles if a given profile is active.
 
@@ -104,6 +104,8 @@ For example, we can create a `production` group that consists of our `proddb` an
 
 Our application can now be started using `--spring.profiles.active=production` to activate the `production`, `proddb` and `prodmq` profiles in one hit.
 
+WARNING: Similar to `spring.profiles.active` and `spring.profiles.include`, `spring.profiles.group` can only be used in non-profile-specific documents.
+This means it cannot be included in xref:features/external-config.adoc#features.external-config.files.profile-specific[profile specific files] or xref:features/external-config.adoc#features.external-config.files.activation-properties[documents activated] by `spring.config.activate.on-profile`.
 
 
 [[features.profiles.programmatically-setting-profiles]]