modify generated documentation file locations

Modify generated documentation file locations so that Swagger UI works
properly.  Add recommendations for the welcome-file-list so that web
apps can serve the documentation correctly.