Ahodges/documentation/lms2525

@sarina @JAAkana  @mhoeber @srpearce please take a look.