Clarifying documentation for Cones

[MicahGale]

Description

This provides some clarification on how Cone surfaces are formed, to address some user confusion that occured.

Fixes #2891.

Checklist

• I have performed a self-review of my own code
• I have run clang-format (version 15) on any C++ source files (if applicable)
• I have followed the style guidelines for Python source files (if applicable)
• I have made corresponding changes to the documentation (if applicable)
• I have added tests that prove my fix is effective or that my feature works (if applicable)

[pshriwise]

Thanks for this update @MicahGale! Minor changes suggested here.

[pshriwise]

Some class name corrections and a typo fix to tackle but then I think this looks good!

[MicahGale]

I came across this documentation:

A one-sided cone is composed of a normal cone surface and an “ambiguity” surface that eliminates the ambiguity as to which region of space is included. This class acts as a proper surface, meaning that unary + and - operators applied to it will produce a half-space. The negative side is defined to be the region inside of the cone.

I feel like "ambiguity" surface here is a bit counterintuitive. Would "disambiguation" surface be better?

[pshriwise]

I came across this documentation:

A one-sided cone is composed of a normal cone surface and an “ambiguity” surface that eliminates the ambiguity as to which region of space is included. This class acts as a proper surface, meaning that unary + and - operators applied to it will produce a half-space. The negative side is defined to be the region inside of the cone.

I feel like "ambiguity" surface here is a bit counterintuitive. Would "disambiguation" surface be better?

Based on the purpose described here, I would agree.

[pshriwise]

Thanks @MicahGale!

[gridley]

LGTM @MicahGale!