I think it would be better if we copy the existing docs into this file.  This is because they (the docs) really are integral to this component.  Plus, if/when the API (or docs) change in the future we can include those changes right here in this package, so that the documentation live alongside the code its documenting.