Readme: say when an authorized application is needed, and when not
The authorization section explained how to get a token, but not when one
is needed, so that every example reaching for auth() looked like a rule
of collocationAnalysis() rather than a consequence of what it queries.
The distinction that matters is not corpus by corpus but frequency
against KWIC: counts cover the whole corpus in either case, so
frequencyQuery(), corpusStats() and collocationScoreQuery() need no token
even on DeReKo - as the Readme's own first example, which queries it
unauthorized, showed all along. Only the snippets of copyrighted texts
are withheld, which is what corpusQuery(metadataOnly = FALSE) and
collocationAnalysis() are after.
And even that follows the licenses of individual texts: DeReKo's Wikipedia
corpora hand out their snippets to anyone, and the Wikipedia talk pages at
instance/wiki and instance/english are under a Creative Commons license
throughout. Both were checked against the live servers: they answer a
plain KorAPConnection() with KWIC snippets.
Change-Id: Ic43cca97a4acf5b6dcc20bf384842d9171cf1d43
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
diff --git a/Readme.md b/Readme.md
index 37ec55e..50468d9 100644
--- a/Readme.md
+++ b/Readme.md
@@ -239,7 +239,11 @@
In order to perform collocation analysis and other textual queries on corpus parts for which KWIC access requires a login, you need to authorize your application with an access token.
-In the case of DeReKo, this can be done in three different ways.
+What a token buys is KWIC access, not the query itself. Frequencies are counted over the whole corpus either way, so `frequencyQuery()`, `corpusStats()` and `collocationScoreQuery()` need no authorization even on DeReKo – the very first example above queries it unauthorized. What an unauthorized application does not receive are the KWIC snippets of copyrighted texts, which is why `corpusQuery()` with `metadataOnly = FALSE` and `collocationAnalysis()`, which reads those snippets, do need one there.
+
+Even that is a matter of the individual text's license rather than of the corpus: DeReKo's freely licensed parts, the Wikipedia corpora among them, hand out their snippets to anyone. Some instances are liberally licensed throughout and need no authorization at all – the German and English Wikipedia talk pages at <https://korap.ids-mannheim.de/instance/wiki> and <https://korap.ids-mannheim.de/instance/english>, both under a Creative Commons license, return KWIC snippets to a plain `KorAPConnection()`.
+
+In the case of DeReKo, authorization can be done in three different ways.
#### 1. The latest and laziest way (available since RKorAPClient 1.0.0)