added ferm documentation examples