oh ok. totally did not understand how this monorepo works. I guess i didn't understand that the root directory was basically a dependency for the examples to work.
Just to step through what I went through to get this working:
1) I land on your main repo page on GH, clone it, and open the readme in my editor. there are no instructions to setup local dev. This means there are no instructions in my editor. I click the link to read the instructions in your docs, in a browser. I click to the second page of the docs. I run the steps. but now a question: do I need to run the rest of the steps? Will these local examples work if I don't fully set up and run the postgres and redis locally?
Lets just assume I don't.
2) Now in my editor I see the examples repo and I move in there and I see a new set of instructions. unfortunately I pick a legitimately broken one and I give up. Then a few days later I decide to try again and I accidentally end up on the solo repo version. It also doesn't work. Now I think it's a package thing and start removing the medplum repo and recloning it to get a clean start. Then I'm convinced that I should follow the instructions inside the example sudirectory. so I try and run npm i from there. but that doesn't work. So eventually I see the monorepo pattern and I start install from root directory but now I'm forgetting to build--because it totally doesn't occur to me that the scripts in examples' package.jsons aren't doing that for me. And I've long forgotten about that one command on that one page of docs. AND I don't understand that the monorepo is like a dependency for the examples. so I thrash about more and eventually give up.
- I guess I'm just too js-dumb to grok this, but I feel like: for me to have divined that working sequence of commands that you just shared, I would either have needed to see all the build patterns myself perfectly (and the mirroring pattern), or take several commands from the second page of installation docs on the web and then chain those to two of the three commands (not that first command!) from a super nested readme inside the repo. i got beat up a bit but im glad im unblocked 😎