Maybe this can be helpful to clarify some key concepts:
I agree, some areas of the manual can be improved, you can help directly here, I suggest starting with small PR: