## Future Enhancements to ApiGenerator
### Multiple File paths and Multiple index sections.
Add support for multiple file paths, and multiple index sections. For example allow indexing of both CakePHP and CakePHP's test suite. But keep the indexes separate and allow for distinct views. Search would still be global an search through all indexes.
### Add ignore classes.
Ignored classes are indexed to allow for display of sub-classes but the classes or filepaths are not visible entities.
### User Edits
There have been several requests from the community for the ability to edit the API documentation. I agree that this is an excellent way to get people involved in improving the documentation. Users would be required to login with their bakery account in order to edit the API docs. User submitted docs would not be saved to the repo, but instead saved as text blobs. A team member would have to edit/approve and apply the changeset. The API would provide a quick visual diff as well as a downloadable diff format patch to make the developer's life easier. All submissions would be required to follow formatting guidelines to ensure proper parsing.
#### Editing a doc block.
Once logged in a member would be able to click an 'edit' link. A form with the existing doc block would be provided with the existing doc block prefilled in. all `/**`, `*`, `**/` would be stripped for editing and added back in before saving. If a doc block has a pending edit a graphic flag will be visible before editing is started.
