RFR: Initial section on testing [v3]

[Igor Ignatyev]

On Mon, 19 Oct 2020 21:00:44 GMT, Igor Ignatyev <iignatyev at openjdk.org> wrote:

>> Excellent comment!  This is exactly the kind of information that needs to be documented. I see no mention of this is
>> the documents in /doc/ so I've added a sentence about this here. There's another example that I was thinking about but
>> I can't recall right now - there's some tag that if specified needs to be placed before the first @run tag. I have it
>> on some wiki page somewhere so it will turn up eventually :-)
>
> I guess you are thinking about `@library`, `@library` tag must be before any `@run` tags, which include `@build`,
> `@compile`, `@ignore` tags.

>  I see no mention of this is the documents in /doc/ so I've added a sentence about this here.

right, we don't have anything about jtreg test in `/doc` (other than about execution), I guess this is partially b/c
jtreg documentation is sufficient enough, partially b/c different areas/teams/components/subcomponents/... have
different views on what good jtreg test is, and partially b/c we have never dedicated enough resources to make it done.
I'd say though that there is a JBS issue (or two) to address that and add documentation about different jtreg tags and
how they are to be used, available test libraries, keywords, etc.

-------------

PR: https://git.openjdk.java.net/guide/pull/30