Dome install instructions

[chapulina]

Resolves #37 .

I recommend seeing the diff between citadel and dome:

meld citadel/ dome/

We should wait until there are ignition-dome Linux nightlies and an initial homebrew bottle before merging. The source instructions will be good to go once gazebosim/gz-launch#39 is in.

My main concern is that with the current site layout, Dome will show up on top of Citadel. It would be nice to be able to add notes next to the release names, like "unstable" and "LTS, recommended".

[zmk5]

Sorry for just kind of barging in with small fixes, but I attempted to do a source install with my Catalina installation and thought to give feedback on the macOS src installation.

[chapulina]

Thanks for the feedback, @zmk5 ! Most of the Catalina instructions here were copied from the citadel ones:

https://github.com/ignitionrobotics/docs/blob/master/citadel/install_osx_src.md

I think we still need some updates on the source code for the instructions here to work for Dome. Do you mind checking the Citadel instructions and opening a PR for them if they need changes?

[zmk5]

So far if you follow the instructions with both Citadel and Dome, it will compile and install with no errors. However, attempting to run ign gazebo, ign gui, and ign launch, you will get dylib errors saying .../install/libignition-gazeboX-ign.X.0.0~pre1.dylib couldn't be loaded and libignition-guiX.dylib and libignition-launchX.dylib couldn't be found. All the other commands for ignition work except that one. I have a feeling this is a Qt issue and not an installation instruction issue because I get Policy CMP0079 warnings all the time for gui and gazebo builds.

I will make a PR for the citadel one for you though with my fixes!

[chapulina]

I will make a PR for the citadel one for you though with my fixes!

Thanks!

attempting to run ign gazebo, ign gui, and ign launch, you will get dylib errors

This is being tracked on this issue, help is appreciated 😄 gazebosim/gz-sim#25

[zmk5]

Thanks Louise! I'll help as much as I can. I would really love to get ignition working on my mac.

[chapulina]

Thank you for all the reviews, we're holding on merging until we have a way to make it clear on the site that Dome is not the recommended version. CC @maryaB-osr

[maryaB-osr]

See #68, I think it'd be best to add Dome above Citadel to keep them in chronological order, and write Dome's description as "Upcoming release, under development" or "Latest features, not yet recommended", or something like that

[chapulina]

best to add Dome above Citadel to keep them in chronological order,

Sounds good to me, let's get that one in first and then I adapt this one and address the remaining comments.