Please see https://runestone-monorepo.readthedocs.io/en/latest/server_feature.html

If you think more needs to be said let me know. If that clarifies things then we can close.

Our classmates found that the instructions were effective to rebuild and to see the changes.
If included in the documentation, It might be helpful for new developers.

1. run pip install rich  in rs folder
2. Run ./build.py --one runestone --restart
3. Wait for runestone to build
4. Run docker compose down
5. Run docker compose up

You do not need to run pip install rich, if you activate the virtual environment with poetry shell from the rs folder.

Steps 4 and 5 are redundant. The --restart flag tells the build script do do just that.

to clarify build instructions, would you like us to add step 2; we can also mention that you don't need to run pip install rich if you have a virtual environment activated. We can add these steps in the https://runestone-monorepo.readthedocs.io/en/latest/building_servers.html#building-and-running-the-servers. These steps were recommended to us by a classmate who was successfully able to build after struggling to do so for a while.

Step 5 on the page you reference says to run poetry shell. It also has quite a few instructions on starting and stopping servers.

Maybe the clarifications should be to this page? https://runestone-monorepo.readthedocs.io/en/latest/server_feature.html

Restating the process there of:

1. make sure you run poetry shell
2. run ./build.py --one XXXX --restart
   To work on features in a single server.

Step 5 on the page you reference says to run poetry shell. It also has quite a few instructions on starting and stopping servers.

Maybe the clarifications should be to this page? https://runestone-monorepo.readthedocs.io/en/latest/server_feature.html

Restating the process there of:

1. make sure you run poetry shell
2. run ./build.py --one XXXX --restart
   To work on features in a single server.

Does XXXX stand for the book?

No, it stands for the service you are rebuilding and restarting.

Most command line commands give you helpful information if you run with the --help flag.

./build.py --help                                                                                            ─╯
Checking your environment
Usage: build.py [--verbose] [--help] [--all] [--push]
        --all build all containers, including author and worker
        --push push all containers to a container registry
        --one <service> build just one container, e.g. --one author
        --restart restart the container(s) after building

        If something in the build does not work or you have questions about setup or environment
        variables or installation, please check out our developer documentation.
        https://runestone-monorepo.readthedocs.io/en/latest/developing.html

Thank you for replying. We will add the clarification to the https://runestone-monorepo.readthedocs.io/en/latest/server_feature.html. Really appreciate your help.