Improve documentation

[jonhadfield]

Summary

• expand README features and examples
• add testing instructions
• add import examples to docs
• update docs intro and index

Testing

• pytest -q

---

https://chatgpt.com/codex/tasks/task_e_685ab373869c8320a5901d3f35256ea9

[Copilot]

Pull Request Overview

This PR improves the documentation by expanding feature descriptions, adding testing instructions, and including new import examples throughout the docs.

• Expanded usage examples in docs/usage.rst
• Updated project overview and added a link to the CHANGELOG in docs/index.rst
• Revised README.md with enhanced feature details, example usage, and testing instructions

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
docs/usage.rst	Added examples for writing and importing hosts entries
docs/index.rst	Updated introductory text and included a link to the CHANGELOG
README.md	Expanded feature list and provided detailed testing instructions

Comments suppressed due to low confidence (3)

docs/usage.rst:25

• Consider adding a brief explanatory note below each heading to clarify the purpose of each example for users unfamiliar with these commands.

**Import entries from a URL**::

docs/index.rst:6

• [nitpick] Clarify in this introductory line that the library primarily manages the system's hosts file to avoid potential ambiguity.

import records from other files or remote URLs.

README.md:33

• [nitpick] Consider removing or adjusting this extra separator if it duplicates an existing heading format, ensuring consistency across the document.

-------------