Add usage of STAR

[Omico]

Improvement of #1554.

[JakeWharton]

I think if we're going to start expanding the docs I would prefer a dedicate page on modeling types. This would cover creating classes, parameterized types, wildcard types, parsing types from reflection/metadata/strings, referencing other generated types, using types to create specs, etc.

The giant index page is a holdover from when all this content was in the README and it doesn't quite translate to the web.

[Omico]

I think if we're going to start expanding the docs I would prefer a dedicate page on modeling types. This would cover creating classes, parameterized types, wildcard types, parsing types from reflection/metadata/strings, referencing other generated types, using types to create specs, etc.

The giant index page is a holdover from when all this content was in the README and it doesn't quite translate to the web.

I completely agree with you. We can make further improvements in other PRs.