docs: document known rough edges (#609)
Start keeping a log of rough edges we've discovered post v1.0.0, so that they're discoverable (along with their workarounds), and so that we can fix them in v2.
This commit is contained in:
parent
72afbc91bd
commit
32d84d8421
1 changed files with 36 additions and 0 deletions
11
internal/docs/rough_edges.src.md
Normal file
11
internal/docs/rough_edges.src.md
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
# Rough edges: API decisions to reconsider for v2
|
||||
|
||||
This file collects a list of API oversights or rough edges that we've uncovered
|
||||
post v1.0.0, along with their current workarounds. These issues can't be
|
||||
addressed without breaking backward compatibility, but we'll revisit them for
|
||||
v2.
|
||||
|
||||
- `EventStore.Open` is unnecessary. This was an artifact of an earlier version
|
||||
of the SDK where event persistence and delivery were combined.
|
||||
|
||||
**Workaround**: `Open` may be implemented as a no-op.
|
||||
Loading…
Reference in a new issue