Seperate document files by types of query

I think the document could be separated into 3 files as 
  - Introduction/general info 
  - Example query API using Perl
  - Example query API using Query DSL
What do you think ?