First draft is up at https://docs.jboss.org/author/display/ISPN/Contributing+to+Infinispan#ContributingtoInfinispan-WritingDocumentationandFAQs Please review it, let me know if you spot any errors ;-) I've tried to follow my own advice when writing this section, but I'm sure I missed something!