「一般的な構成として、@DataSource@はトップレベルで提供され」が変です。
全体的に以下の構成になっています。
```
dataSource { ... }
environments {
    development {
        dataSource { ... }
    }
    test {
        dataSource { ... }
    }
    production {
        dataSource { ... }
    }
}
```
ここで言いたいのは共通的な項目はトップレベルの`dataSource { ... }`で定義し、それ以外で環境ごとに設定はenviromentsごとの`dataSource { ... }`で定義出来るよということかと思います。

なので
「共通的な設定はトップレベルで提供され、...」などでどうでしょうか。

また、上記にすると後半は
「、@environments@ブロックでは」「、@environments@ブロックには」のほうが自然な気がします。