improve fly docs

[finishes #77702506] [finishes ##77702312] [finishes #77702418]