additions to waves docs