[FAB-12223] Adding FAQ file

With master build instructions and inter versions explanations

Change-Id: I278d35ec856f2f258d08c0ea51debf0dfb9c8a4b
Signed-off-by: gennady <gennady@il.ibm.com>
(cherry picked from commit b1710e9)

Author: gennadylaventman

FAQ.md

@@ -0,0 +1,40 @@
+# Frequently Asked Questions - Hyperledger Fabric Shim for Java chaincode
+
+### Q. How to build latest master code?
+
+#### Install prerequisites
+
+Make sure you installed all [fabric prerequisites](https://hyperledger-fabric.readthedocs.io/en/latest/prereqs.html)
+
+Install java shim specific prerequisites:
+* Java 8
+* gradle 4.4
+
+#### Build shim
+
+Clone the fabric shim for java chaincode repo.
+
+```
+git clone https://github.com/hyperledger/fabric-chaincode-java.git
+```
+
+Build java shim jars (proto and shim jars) and install them to local maven repository.
+```
+cd fabric-chaincode-java
+gradle clean build install
+```
+
+Build javaenv docker image, to have it locally.
+```
+gradle buildImage
+```
+
+#### Update your chaincode dependencies
+
+Make your chanincode depend on java shim master version and not on version from maven central
+
+```
+dependencies {
+    compile group: 'org.hyperledger.fabric-chaincode-java', name: 'fabric-chaincode-shim', version: '1.4.0-SNAPSHOT'
+}
+```

README.md

@@ -1,13 +1,13 @@
 # Hyperledger Fabric Shim for Java chaincode
 
 This is a Java based implementation of Hyprledger Fabric chaincode shim APIs, which enables development of chaincodes using Java language.
-The following instructions are intended for a contributor or early adopter that needs to
-be able to build and test the Java chaincode shim, docker image and protobuf artifacts.
 
 Application developers interested in developing smart contracts (what we call chaincode) for Hyperledger Fabric should
 read the tutorial in TUTORIAL.md file and visit
 `Chaincode for developers <https://hyperledger-fabric.readthedocs.io/en/latest/chaincode4ade.html>`__.
 
+Contributors or early adopters who need to be able to build and test recent Java chaincode shim, should reference [FAQ.md](FAQ.md) file.
+
 This project creates `fabric-chaincode-protos` and `fabric-chaincode-shim` jar
 files for developers consumption and the `hyperledger/fabric-javaenv` docker image
 to run Java chaincode.
@@ -24,27 +24,4 @@ The "fabric-chaincode-docker" folder contains instructions to the build
 `hyperledger/fabric-javaenv` docker image.
 
 The "fabric-chaincode-example-gradle" contains an example java chaincode gradle
-project that includes sample chaincode and basic gradle build instructions.
-
-## Prerequisites
-* Java 8
-* gradle 4.4
-
-## Build shim
-
-Clone the fabric shim for java chaincode repo.
-
-```
-git clone https://github.com/hyperledger/fabric-chaincode-java.git
-```
-
-Build and install java shim jars (proto and shim jars).
-```
-cd fabric-chaincode-java
-gradle clean build install
-```
-
-Build javaenv docker image, to have it locally.
-```
-gradle buildImage
-```
+project that includes sample chaincode and basic gradle build instructions.