diff --git a/docs/proposed/http-storage-node-protocol.rst b/docs/proposed/http-storage-node-protocol.rst index 5e46480d3..c2a68b3ee 100644 --- a/docs/proposed/http-storage-node-protocol.rst +++ b/docs/proposed/http-storage-node-protocol.rst @@ -39,7 +39,10 @@ Tahoe pays a substantial price: * The Foolscap developer community is very small. The implementation therefore advances very little and some non-trivial part of the maintenance cost falls on the Tahoe project. * The extensible serialization system imposes substantial overhead for the simple data structures Tahoe exchanges. - Tahoe therefore presents a more sluggish experience to users and taxes servers more greatly than is necessary. +* Foolscap encourages a "remote object" style of protocol design with involves many client-server interactions. + However, Foolscap does not implement "promise pipelining". + The result is that Foolscap encourages a protocol that requires many round-trips between client and server. +* The serialization overhead combined with the many round-trips result in Tahoe presenting a more sluggish experience to users and taxes servers more greatly than is necessary. HTTP ~~~~