Improve section about namespace support

https://rescript-lang.org/docs/manual/latest/build-configuration#name-namespace

1. Add examples for possible library configurations, especially also because it is needed with rewatch/monorepos
2. It says that "namespace" will be converted to PascalCase like "name" but this does not seem to be the case in bsb.