Next documentation iteration: umbrella issue

[gvdongen]

This umbrella issue groups issues related to the new iteration of the docs, in which we want to improve the structure, give more context, and have more unified language.

Improving overall structure

Beta Give feedback

1. Split up Java and TS SDK docs #269
   +0
   
2. Add concepts pages with bullet points #266
   +0
   
3. Consider renaming the "SDKs" node of the documentation tree #207
   +0
   
4. Rename managed service to Restate Cloud #230
   +0
   
5. Make code snippets tested and compiled on merge and release #295
   4 of 4
   +0
   
6. Improve sidebar structure #296
   +0
   

Giving more context

Beta Give feedback

1. Improve overview page #267
   +0
2. Write concepts - Restate in your stack #271
   +0
3. Write docs on utility methods for pseudorandom number/uuid generation #185
   +0
   
4. Make the two service handler implementation styles (contract-first vs dynamic TypeScript handlers) more explicit and upfront #219
   +0
5. Write kotlin SDK documentation #227
   +0
   
6. Restate Architecture page needs to be updated #231
   +0
7. Improve Kafka integration docs #237
   +0
8. Improve the explanation of journaling in the Tour #238
   +0
9. Add CLI to the Tour of Restate #257
   +0
   

Making language more uniform

Beta Give feedback

1. Should we remove references to gRPC when talking about the service contract? #69
   question +1
2. Make the language used throughout the docs more uniform #63
   4 of 4
   +0
   
3. Terminology renaming #272
   6 of 6
   +0
4. Spell and style check files under restate directory #150
   +0
5. Spell and style check files SDK docs #151
   +0

Bugs

Beta Give feedback

1. Document grpc quickstart TS template in docs #323
   +0
   
2. Improve durable execution animation #343
   +0