DOC: Add extra documentation to difference

[theroggy]

Starting point to exchange some ideas about what would be useful information to add to shapely.difference and similar functions in shapely.

[coveralls]

Pull Request Test Coverage Report for Build 5754649306

Warning: This coverage report may be inaccurate.

This pull request's base commit is no longer the HEAD commit of its target branch. This means it includes changes from outside the original pull request, including, potentially, unrelated coverage changes.

• For more information on this, see Tracking coverage changes with pull request builds.
• To avoid this issue with future PRs, see these Recommended CI Configurations.
• For a quick fix, rebase this PR at GitHub. Your next report should be accurate.

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage increased (+0.3%) to 87.759%

---

Totals
Change from base Build 5708535760:	0.3%
Covered Lines:	2545
Relevant Lines:	2900

---

💛 - Coveralls