Author: jensg
Date: Mon Jun 1 23:15:51 2015
New Revision: 1683021
URL: http://svn.apache.org/r1683021
Log:
Updated new language bindings document
Modified:
thrift/cms-site/trunk/content/docs/HowToNewLanguage.md
Modified: thrift/cms-site/trunk/content/docs/HowToNewLanguage.md
URL:
http://svn.apache.org/viewvc/thrift/cms-site/trunk/content/docs/HowToNewLanguage.md?rev=1683021&r1=1683020&r2=1683021&view=diff
==============================================================================
--- thrift/cms-site/trunk/content/docs/HowToNewLanguage.md (original)
+++ thrift/cms-site/trunk/content/docs/HowToNewLanguage.md Mon Jun 1 23:15:51
2015
@@ -35,9 +35,16 @@ Now fork the [Apache Thrift code base](h
The minimum required feature set should cover at least:
-* Transports: Sockets, HTTP, Buffered, Framed
-* Protocols: Binary required, JSON and Multiplex recommended
-* Server types: SimpleServer
+* Transports: Sockets, Buffered, Framed required, HTTP client recommended
+* Protocols: Binary and Multiplex required, JSON recommended
+* Server types: SimpleServer required
+
+### Other recommended features
+
+* Transports: HTTP server, Pipes, NamedPipes (where it makes sense)
+* Protocols: Compact
+* Server types: Nonblocking, Threaded and/or Threadpool server implementation
+
### Final things
@@ -51,7 +58,7 @@ The minimum required feature set should
Note that the 4 implementation steps are not really a linear process, it is
more kind of an iteration. Even if the code that comes out of the generator
finally is compileable and does not spit out any warnings and seems to run
fine, you still will run into problems as you move on with implementing library
and tests. This is fully normal and expected.
-It is a good idea to post your work early on the mailing lists, and to create
the JIRA ticket early - that's why this particular point is on top of the list.
This serves not only the purpose of announcing the work you are about to do, it
is also a good starting point for other people who might be just looking for
exactly that stuff. You will be able not only to get valuable early feedback,
but probably also be able to raise some support with implementation and/or
testing.
+It is a good idea to post your work early on the mailing lists, and to create
the JIRA ticket early - that's why this particular point is on top of the list.
This serves not only the purpose of announcing the work you are about to do, it
is also a good starting point for other people who might be just looking for
exactly that stuff. You will be able not only to get valuable early feedback,
but probably also be able to raise some support with implementation and/or
testing. Having someone else looking over your code (or reviewing each other)
is generally a good thing, especially with regard to the overall quality of the
contribution you are about to do.
Happy coding!
