documentation - optional parameters for home action