docs: fix issue 5048214 and clarify some variable names Change-Id: Id142fe561690376783e0ec8af23a4f26df785e39