Improve API documentation structure and clarity

[stevenkiwanukakafeero]

The current API documentation lacks clear structure and readability.

Problems:

• Poor formatting
• No clear sections
• Hard to follow for new developers

Suggested improvement:

• Add structured sections
• Improve formatting using tables and headings
• Add examples and best practices