Define available jenkins configuration parameters

[M-Davies]

• Centralised location for groovy config param descriptions and usage
• Also deletes the FAQ.md of this repo as it's not being removed by pipeline: move to separate repo temurin-build#2463

Part 1 of adoptium/temurin-build#2129
Signed-off-by: Morgan Davies [email protected]

[github-actions]

Thank you for creating a pull request!
In order to run the pipeline tests I require an admin to post the following comment: run tests

[sxa]

I'm not sure about a full removal of the FAQ.md. It is very difficult for people to get up to speed in stuff in our repositories and a basic document of "To do this, change this file" without all the background infromation is extremely valuable (I made a similar comment in adoptium/infrastructure#1974 (review)). If you really think we have no such content left then I mighe be ok with that, but it seems unlikely ...

[M-Davies]

@sxa The FAQ is still going to available in https://github.com/AdoptOpenJDK/openjdk-build, even after #2463. I'm just removing it from here so we don't have two duplicate FAQ's floating around

[sxa]

available

There is stuff that would be specific to this repository - in fact a lot of the "end-user" stuff including running make-adopt-build-farm.sh vs makejdk-any-platform.sh could be in one here and expecting people to go to a repository about the pipelines for that and stuff like the "find your way around" chart and compiler prereqs seems a little odd so the information should perhaps be split between both repositories too.

[M-Davies]

available

There is stuff that would be specific to this repository - in fact a lot of the "end-user" stuff including running make-adopt-build-farm.sh vs makejdk-any-platform.sh could be in one here and expecting people to go to a repository about the pipelines for that and stuff like the "find your way around" chart and compiler prereqs seems a little odd so the information should perhaps be split between both repositories too.

In that case, would you prefer two FAQ's? One here and one in openjdk-build, each answering questions about their respective repositories?

[sxa]

available

There is stuff that would be specific to this repository - in fact a lot of the "end-user" stuff including running make-adopt-build-farm.sh vs makejdk-any-platform.sh could be in one here and expecting people to go to a repository about the pipelines for that and stuff like the "find your way around" chart and compiler prereqs seems a little odd so the information should perhaps be split between both repositories too.

In that case, would you prefer two FAQ's? One here and one in openjdk-build, each answering questions about their respective repositories?

I think that's the only sensible choice unless the infromation specific to this repository is made available elsewhere in here.

[karianna]

LGTM

[M-Davies]

Twin PR for updating the FAQ of openjdk-build -> adoptium/temurin-build#2506

[sxa]

LGTM as far as I can tell - thanks :-)