If multiple developers or writers are working on a project, each should be able to document a specific set of paths (/mypath and /yourpath); but the Swagger 2.0 spec does not provide for this, perhaps because of issues with the JSON schema spec.
Whatever the internal block, a higher-level description language would add value by allowing for the workflow, especially for a complex API with a large number of paths.
In short, the user should be able to use a separate file to document a path.
Thanks for the suggestion. I'm happy to say that this is now fully resolved, with RepreZen API Studio's advanced multi-file support.
Check out the video and feature tour for more information.
Ted Epstein, CEO