#928: rose edit: document API for custom sub-panel widgets

This closes #928. @arjclark, please review.