re-introducing having references to code blocks instead of inlining code directly

Also merge with recent documentation changes
re-introducing having references to code blocks instead of inlining code directly
Merge branch 'enhancedocs' of github.com:dominiqueplante/docs

Conflicts:
	version_2_5/docs/client-api/querying/static-indexes/searching.markdown
Merge branch 'master' of github.com:ravendb/docs