adapting to gh documentation