updating docs to drop using --wipe flag

[muhamadazmy]

Fixes #439

Question: How to preview mdx files locally

[cloudflare-workers-and-pages]

Deploying documentation with    Cloudflare Pages

Latest commit:	bd68eba
Status:	✅  Deploy successful!
Preview URL:	https://2349b320.documentation-beg.pages.dev
Branch Preview URL:	https://issue439.documentation-beg.pages.dev

View logs

[tillrohrmann]

Thanks for updating the documentation @muhamadazmy. The changes look good to me.

For a bit of context for @gvdongen: We want to discourage the wipe command because it is a) dangerous, b) should hopefully no longer be needed with our backwards compatibility and c) wouldn't work in the distributed set up as it is implemented right now. Instead we ask people to delete the data directory manually if they really need to. The wipe command itself is still there but it is hidden now (not visible when running restate-server --help).

[tillrohrmann]

Maybe replace ${HOST} with <NODE_NAME>. By default <NODE_NAME> == ${HOST} but one can configure it to something else.

[tillrohrmann]

Suggested change

	To start the Restate Server from a clean slate, stop the server then wipe ongoing invocations and K/V state:
	To start the Restate Server from a clean slate, stop the server and then delete the data directory:

[tillrohrmann]

Maybe we should state that this deletes all state/data of the Restate server.

[gvdongen]

@tillrohrmann I think there is a difference in how you use Restate locally for development/learning, vs production usage.
I think when developing locally, it's perfectly fine to use this a lot.

When developing locally, I still use it in quite some circumstances:

• Running an example, then another example and wanting to start from a clean slate
• Having many in flight invocations, delayed invocations and timers that I want to stop immediately to start over
• It's still the fastest way to kill all invocations and state, if I have messed things up. We still don't have a kill all invocations command.

But yes, maybe doing rm -rf is also fine.

[muhamadazmy]

@gvdongen The argument --wipe is still available and you can use it. It's just hidden for normal users, and is then removed from documentations. You still can perfectly do restate-server --wipe all .

[tillrohrmann]

LGTM. +1 for merging.