Comments added, updated BaseSpace Ruby SDK name, added getopt as required

Added comments about installing and troubleshooting, if BaseSpace Ruby SDK fails to install easily.

Updated BaseSpace Ruby SDK name.

Added getopt as required. That makes it easier to spot, if BaseSpace Ruby SDK failed to install properly.