document the decorating functionality