ENT-12600: compile: Documented script

[larsewi]

• compile: fixed shellcheck issues
• compile: Reduced verbosity of script
• compile: Fixed inconsistent indents
• compile: Placed block terminator on a new line for consistency
• compile: Documented script

Build with no tests

Example output:

$ PROJECT=nova ROLE=hub ./buildscripts/build-scripts/compile
 ---snip---
compile: Debug: Running make in core repo...
compile: Debug: Running make install in core repo...
compile: Debug: Running make in enterprise repo...
compile: Debug: Running make install in enterprise repo...
compile: Debug: Running make in nova repo...
compile: Debug: Running make install in nova repo...
compile: Debug: Running make install in masterfiles repo...

^ Snipped noise from sourced scripts

[olehermanse]

Not for this PR, but we should probably align this with the names we use elsewhere, i.e.
enterprise instead of nova and client instead of agent.

[olehermanse]

LGTM but nice if @craigcomstock can review as well.

[craigcomstock]

here, as in another script I reviewed you might include two blocks: one for community, the other for ent.

[craigcomstock]

Interesting to break it up separate for nova and the -k for keep going. I suppose these are reasonable but I wonder if just make install wouldn't make more sense. We should get about the same output. The advantage of -k is we get more of the problems with each run. I never use that option as I guess I would prefer to see the first error, fix it, repeat. Also if -j is anything but 1 I'm not sure if -k really buys us much in terms of readability.