Get to the point faster with the Runtime docs #1252
Description
What is the type of issue?
Something else
What is the issue?
The runtime docs spend a lot of time telling you what runtimes are in abstract terms when there's - I would guess - a much more concrete user need for these docs. If you read the docs from top to bottom and start writing code that has requirements, you pretty quickly get tired of typing .pipe(Effect.provide(NodeContext.layer)) every time you run any Effect that requires Fs access.
I think the docs could do better to mention this up front - talking about usecases as well as abstractly what Runtimes are.
It would also - for this usecase of "I'm using a Runtime because I don't want to re-provide my layers everywhere" it'd also be great to show how to create a Runtime that customizes multiple layers, because that is not super apparent either, without reading several more pages of docs.
Where did you find it?
No response