diff --git a/packages/composer-website/jekylldocs/business-network/query.md b/packages/composer-website/jekylldocs/business-network/query.md
index 0a9ad1e72e..16e1b1854c 100644
--- a/packages/composer-website/jekylldocs/business-network/query.md
+++ b/packages/composer-website/jekylldocs/business-network/query.md
@@ -9,11 +9,11 @@ excerpt: Queries are used to return data about the blockchain world-state; for e
 
 # Querying business network data
 
->**Warning**: The status of this feature is experimental. You **must** use Hyperledger Composer v0.8+ with the the HLFv1 runtime to use queries. We welcome feedback and comments while we continue to iterate upon query functionality. The API may change based on the feedback received. In future releases we plan to extend this feature with a Composer specific query language, and data-binding to assets, participants and transactions.
+>**Warning**: The status of this feature is experimental. You **must** use Hyperledger Composer v0.8+ with the the HLFv1 runtime to use queries. We welcome feedback and comments while we continue to iterate upon query functionality. The API may change based on the feedback received.
 
 Queries are used to return data about the blockchain world-state; for example, you could write a query to return all drivers over a defined age parameter, or all drivers with a specific name.
 
-Queries are an optional component of a business network definition, written in a query file (`.qry`) file.
+Queries are an optional component of a business network definition, written in a single query file (`queries.qry`).
 
 Note: Queries are supported by the {{site.data.conrefs.hlf_full}} v1.0, embedded and web runtimes. The query support for the embedded and web runtimes currently has limitations and is unstable. When using the {{site.data.conrefs.hlf_full}} v1.0-beta runtime {{site.data.conrefs.hlf_full}} must be configured to use CouchDB persistence. Queries are **not** supported with the {{site.data.conrefs.hlf_full}} v0.6 runtime.
 
diff --git a/packages/composer-website/jekylldocs/reference/query-language.md b/packages/composer-website/jekylldocs/reference/query-language.md
index f170a27460..ef15531c76 100644
--- a/packages/composer-website/jekylldocs/reference/query-language.md
+++ b/packages/composer-website/jekylldocs/reference/query-language.md
@@ -9,7 +9,7 @@ excerpt: The [**Hyperledger Composer query language**](./query-language.html) de
 
 # {{site.data.conrefs.composer_full}} Query Language
 
-Queries in {{site.data.conrefs.composer_full}} are written in a bespoke query language. Queries are defined in one or more query files (`.qry`) within a business network definition.
+Queries in {{site.data.conrefs.composer_full}} are written in a bespoke query language. Queries are defined in a single query file called (`queries.qry`) within a business network definition.
 
 ## Query Syntax
 
diff --git a/packages/composer-website/jekylldocs/tutorials/developer-guide.md b/packages/composer-website/jekylldocs/tutorials/developer-guide.md
index 1fd990f057..13f99c301d 100644
--- a/packages/composer-website/jekylldocs/tutorials/developer-guide.md
+++ b/packages/composer-website/jekylldocs/tutorials/developer-guide.md
@@ -114,8 +114,7 @@ participant Trader identified by tradeId {
     o String firstName
     o String lastName
 }
-transaction Trade identified by transactionId {
-    o String transactionId
+transaction Trade {
     --> Commodity commodity
     --> Trader newOwner
 }
diff --git a/packages/composer-website/jekylldocs/tutorials/playground-guide.md b/packages/composer-website/jekylldocs/tutorials/playground-guide.md
index a306cb5987..0ed07f42a2 100644
--- a/packages/composer-website/jekylldocs/tutorials/playground-guide.md
+++ b/packages/composer-website/jekylldocs/tutorials/playground-guide.md
@@ -46,8 +46,7 @@ participant Trader identified by tradeId {
     o String firstName
     o String lastName
 }
-transaction Trade identified by transactionId {
-    o String transactionId
+transaction Trade {
     --> Commodity commodity
     --> Trader newOwner
 }