Update native configuration file best practices

[galderz]

Placing custom configuration files in META-INF/native-image/<group-id>/<artifact-id> is the best way. It doesn't get in the way of what Quarkus generates, works out of the box without additional configuration and does not produce any native build warnings. Alternative methods have been removed to avoid confusion.

[github-actions]

🙈 The PR is closed and the preview is expired.

[geoand]

Is this related to #38118?

[zakkak]

Is this related to #38118?

Yes, IMO we need a combination of these two PRs.

[galderz]

Is this related to #38118?

No it's not. This PR is the result of my own experiments.

[zakkak]

This PR is the result of my own experiments.

@galderz sure, I think what @gsmet @geoand wanted to highlight here is that both PRs are touching the same issue. And IMO they should be combined to give the best result.

Update: Ooops wrong mention :)

[geoand]

@zakkak exactly

[galderz]

Hmm, looking at #38118, the changes there are minimal and still suggest using an experimental flag that you get a warning with (ResourceConfigurationFiles et al). So I favour my changes instead of #38118.

[zakkak]

As mentioned in #38118 (review)

@galderz it looks like @dliubars updated #38118 and it now only includes the following changes (i.e. it no longer suggests using experimental options) which are currently missing from this PR:

1. replace references to resources-config.json with resource-config.json
2. replace references to reflection-config.json with reflect-config.json

I suggest you either:

1. merge Rename reflection-config.json into reflect-config.json and resources-config.json into resource-config.json #38118 and rebase this PR
   or
2. cherry-pick @dliubars commit (e911584) in your branch

[galderz]

I merged #38118 and I've now rebased this PR with the changes there.

[zakkak]

LGTM. Just added a suggestion that IMO makes the corresponding sentence a bit easier to read.

[quarkus-bot]

Status for workflow Quarkus Documentation CI

This is the status report for running Quarkus Documentation CI on commit c575a2d.

✅ The latest workflow run for the pull request has completed successfully.

It should be safe to merge provided you have a look at the other checks in the summary.