David Fifield:
On Fri, Jul 20, 2018 at 04:12:21PM -0400, John Helmsen wrote:
We are in the process of writing the documentation for Marionette, but the documentation on the web page should be sufficient for at least getting a full evaluation started. We'd like to have the evaluation complete by the end of next month, hopefully the middle of next month, and stand ready to make any and all changes necessary.
A full set of documentation will also be written for designing your own protocols. This is in process.
Please let us know what you need.
The Tor Browser developers may have more specific requests, but I can suggest some steps to get started.
Open a ticket at https://trac.torproject.org/ for discussion and to track progress. Type: project Component: Applications/Tor Browser Keywords: marionette The old ticket for FTE is a good reference: https://bugs.torproject.org/10362
And then it would help if you port your build process to the Tor Browser build system. General information: https://trac.torproject.org/projects/tor/wiki/doc/TorBrowser/Hacking First, just build git clone https://git.torproject.org/builders/tor-browser-build.git cd tor-browser-build git checkout tbb-8.0a9-build3 make testbuild # or, e.g., testbuild-linux-x86_64 Then you'll have to add a new project (consisting of a "build" and "config" file) for Marionette and each of its dependencies. You can copy from existing projects as templates. Here is the meek project, for example: https://gitweb.torproject.org/builders/tor-browser-build.git/tree/projects/m... You'll also need to add bridge lines to: https://gitweb.torproject.org/builders/tor-browser-build.git/tree/projects/t... To build just one project, not an entire release, do e.g.: rbm/rbm build gmp --target testbuild --target torbrowser-linux-x86_64 rbm/rbm build marionette --target testbuild --target torbrowser-linux-x86_64
Thanks David. Yes, those are good first steps to get started. Experience shows that getting things running for Linux is the easiest part, thus I'd suggest to start with that one first.
There is no need to have everything ready for all supported platforms to get your PT integrated. It's fine to ship it for the alpha for some platforms only to further shake out bugs and make it more robust. Thus, don't hesitate to put things into review state early on.
Finally, don't hesitate as well to ask in #tor-dev or by mail or on the trac ticket (I'll have it on my radar) in case you are stuck or are running into issues, we are happy to help.
Georg