Temurin-build: Miscellaneous Minor Doc Enhancements and Fixes

[M-Davies]

👾 Description of the issue
After the effort to split openjdk-build into two, we find ourselves with some documentation that is out of date, jumbled or outright wrong in some places. This issue intends to amend these irregularities by tidying up the visual features of this repo. Some ideas:

• We have a lot of .md files at the root of this repo that could be moved into their own directory (called docs/ maybe?). NOTE: SECURITY.md and LICENSE would need to stay as they are special files that GitHub needs to have at the repository root.
• README.md contains a few images that are invalid (i.e. they show a blank image). It would be good to have these replaced or removed.
• The Metadata section of the README file above can be removed as it is more a part of the pipeline side of the project instead of the build side.
• CONTRIBUTING.md could be condensed down to be less wordy. It's probably quite a daunting document to read for new contributors.
• The FAQ contains an error that states that the make-adopt-build-farm.sh script is a G script, not a S script
• There are probably more that I have missed as this was just from a quick look through.

📋 Step by Step

To solve this issue and contribute a fix you should check the following step-by-step list. A more detailed documentation of the workflow can be found here.

• [x] Claim this issue: Comment below.
• [x] Fork the repository in github by simply clicking the 'fork' button.
• [x] Check out the forked repository
• [x] Create a feature branch for the issue. We do not have any naming definition for branches.
• [x] Commit your changes.
• [x] Start a Pull Request.
• [x] Done 👍 Ask in comments for a review :)
• [x] If the reviewer find some missing pieces or a problem they will start a discussion with you and describe the next steps how the problem can be solved.
• [ ] You did it 🎉 We will merge the fix in the master branch.
• [ ] Thanks, thanks, thanks for being part of this project as an open source contributor ❤️

🤔❓ Questions

If you have any questions just ask us directly in this issue by adding a comment. You can join our community chat at Slack. Next to this you can find a general manual about open source contributions here.

[ljessicc]

Hi, I am Jessica and I'm new to contributing on projects. I'm currently looking for a first good issue to start contributing and this seems like it could be a good one. I would like to give it a go. Thank you

[smlambert]

Welcome @ljessicc ! It is now assigned to you, if you have any questions, please feel free to ask them in this issue.

[ljessicc]

Very well. Thank you

[ljessicc]

Are the images mentioned in the README.md, the links referring to [slack], [DockerFileCheck]? I have tried finding valid updated links to replace these but I haven't been able to. Should I only delete the links or the whole paragraphs pointing to them?

[ljessicc]

Actually I just noticed many of the links in the FAQ.md are invalid

[M-Davies]

Are the images mentioned in the README.md, the links referring to [slack], [DockerFileCheck]? I have tried finding valid updated links to replace these but I haven't been able to. Should I only delete the links or the whole paragraphs pointing to them?

DockerFileCheck can probably be deleted, I don't think that job exists anymore after the rejig of the docker pipelines a while back. The image icon url for slack can probably be replaced by any generic one found on google. As for the actual link that the icon will take you too, it is possible to copy a link to a channel in slack by right clicking on the channel. Maybe we could replace the https://slackin-jmnmplfpdu.now.sh/ part with whatever that link may be?

[ljessicc]

Ok. Thanks

[ljessicc]

I am done with my changes, please review