How to document my page object

Question

What are some efficient and non-tedious ways to document my page objects?

What I first did was take screen shots of my screen and label each page object to its corresponding web element but this turned out to be a night mare and now I am wondering of more convenient ways to document my page objects so that others can digest which methods or page elements go where with little effort.

---

I use selenium and page object model to run my tests.

Answer 1

I recommend avoiding external documentation because no one wants to maintain it. Instead, use comments in your code and useful names for your classes and methods. And ask someone to review some of your code specifically with those considerations in mind.

Answer 2

Even i feel external documentation is a burden, better way will be distributing page elements meaningfully in into different smaller classes with comments and apt names.