update documentation with a small section about method filling