Document and Update solution files

[AndrewCook]

In July 2020 getting small basic's source code to run on a new contributor's machine was a cumbersome process. This should be improved with updates to source code and documentation that clearly states what is needed as well as working to automate away as many steps as possible that a contributor needs to complete to have the source code running on their machine.

[nonkit]

@AndrewCook, I've written an article in TechNet Wiki. Does following article help this issue especially for documentation?
Microsoft Small Basic Online v1.0: How to Build

[AndrewCook]

@nonkit That does help. 👍 I'm also planning on adding similar documentation to the README of this repo to improve discoverability.

[nonkit]

@AndrewCook, good idea!

[Youssef1313]

Hi @AndrewCook!
I came to this repository by chance, and I'm willing to contribute.
For me, opening the solution was very straightforward. Just did a dotnet restore, then opened the sln file in Visual Studio. Then, just set SmallBasic.Editor as the startup project. After that, just a build & run (which will automatically restore npm packages for SmallBasic.Client). Finally, it should work. The npm restore still haven't finished yet at the time of writing this (it takes a while due to relatively slow internet connection). I'll update the comment after the npm restore finishes. But I'm expecting everything to work just fine.

Can you elaborate more on what can make this process cumbersome?

[Youssef1313]

Ok I actually got rzc discover exited with code 1.

I'm not sure of its cause.