On Jul 27, 2014, at 7:26 PM, Daniel Sank <sank.daniel@gmail.com> wrote:

I've been trying to address ticket 7274

https://twistedmatrix.com/trac/ticket/7274

To do this, I am trying to understand the PB protocol. While I found a spec for banana in twisted-daniel/docs/core/specifications/banana.rst, I have not found anything similar for pb. I've been piecing it together by writing little test scripts, but it is slow going. In particular, it is very difficult to understand the meaning of verbs like "cook" and "preserve" and nouns like "persistent store" without some global picture of what's going on.

1. Is there some kind of narrative documentation on how pb works under the hood?

I don't believe there is.

2. Is there a specification for the pb dialect of banana?

Beyond the code, no.

3. Is there anyone else out there interested enough in pb to want to work with me to figure things out and produce documentation if there isn't any currently?

I would be happy to answer questions, but obviously I'm not super responsive :).  Let me know what you need.

-glyph