Separate documentation into "Install" and "Build from Source"

[ReeceHumphreys]

• Tickets addressed: Closes Update Documentation to reflect new pip install instructions #1121
• Review: By commit
• Merge strategy: Merge (no squash)

Description

Now that bsk is available as a wheel on PyPI, the documentation needs to reflect when users should install from PyPI and when they should build from source.

This PR introduces a new “Install” section that explains how to install the wheel from PyPI and outlines when building from source is required.

The existing “Build” section has been moved under a new “Build from Source” category to better separate installation methods and developer workflows.from source.

Verification

N/A

Documentation

Removed old docs about building wheels locally

Future work

N/A

[schaubh]

found some small edits to make. The RST documentation didn't build without warnings. I marked what needs to be fixed. The pipInstall.rst page can use more updating as it talks about -e not being supported, etc.

[schaubh]

Howdy Reece, nice work. The only thing I see missing is adding a line in the BSK Release Notes that the install instructions have been updated to separate installing via pip and installing from source. Otherwise good to go. Thanks for adding these release notes.

[schaubh]

Nice branch. Thanks for updating all the install and build instructions, including the often forgotten README.md file