improved docs about application and module namespace

fixes #3539