Merge branch 'tokenrevamp' of github.com:corda/samples-java into tokenrevamp

merge

Author: peterli-r3

Tokens/README.md

@@ -1,18 +1,21 @@
-## samples-java/token-cordapps
+## Tokens CorDapp Samples
 
 This folder features [TokenSDK](https://training.corda.net/libraries/tokens-sdk/) sample projects.
 
+### [fungible house token](./fungiblehousetoken):
+This Cordapp serves as a basic example to demostrate how to tokenize an asset into [Fungible](https://training.corda.net/libraries/tokens-sdk/#fungibletoken) tokens in Corda utilizing the TokenSDK. 
+
 ### [bike market](./bikemarket):
-This sample Cordapp demonstrate some simple flows related to the token SDK.  
+This sample Cordapp demonstrate all four out-of-box TokenSDK flows (Create, Issue, Move, and Redeem flows). The cordapp demonstrate how to tokenize an asset as non-fungible tokens and excute a few transacting procedures. 
 
-### [dollar to Token DvP](./dollartohousetoken):
-This CorDapp serves as a basic example to create, issue and perform a DvP (Delivery vs Payment) of an [Evolvable](https://training.corda.net/libraries/tokens-sdk/#evolvabletokentype), [NonFungible](https://training.corda.net/libraries/tokens-sdk/#nonfungibletoken) token in Corda utilizing the TokenSDK.  
-
-### [fungible house token](./fungiblehousetoken):
-This Cordapp serves as a basic example to create, issue, move [Fungible](https://training.corda.net/libraries/tokens-sdk/#fungibletoken) tokens in Corda utilizing the TokenSDK.  
+### [dollar to house token](./dollartohousetoken):
+This CorDapp demonstrate a DvP (Delivery vs Payment) of an [Evolvable](https://training.corda.net/libraries/tokens-sdk/#evolvabletokentype), [NonFungible](https://training.corda.net/libraries/tokens-sdk/#nonfungibletoken) house token in Corda utilizing the TokenSDK. 
 
 ### [stock pay dividend](./stockpaydividend):
 This CorDapp aims to demonstrate the usage of TokenSDK, especially the concept of [EvolvableToken](https://training.corda.net/libraries/tokens-sdk/#evolvabletokentype) which represents stock. You will find the StockState extends from EvolvableToken which allows the stock details(eg. announcing dividends) to be updated without affecting the parties who own the stock.  
 
 ### [spaceships-javaAPIs](./spaceships-javaAPIs):
-This CorDapp contains examples using new [Java APIs](https://medium.com/corda/corda-tokens-made-easy-with-new-java-apis-83095693d72) introduced in Token SDK 1.2 - It makes of use of utility functions and the new Java Token Builders.  
+This CorDapp contains examples using new [Java APIs](https://medium.com/corda/corda-tokens-made-easy-with-new-java-apis-83095693d72) introduced in Token SDK 1.2 - It makes of use of utility functions and the new Java Token Builders. The lastes Java APIs were indeed later implmented for all of the samples above as well. 
+
+### [token to friend](./tokentofriend):
+This CorDapp showcase a simple token issuance use case. You can attach a secret message with the token and your friend can retrive it with the credential that you inputed when creating the token. This cordapp come with a nice looking front end using Reactjs. Feel free to give a try on the app!