Add some comments for Server re-org sample

[maria-robobug]

No description provided.

[osfameron]

Briefly discussed with Maria - not sure about these comments:
Looks like they are replicating a lot of the information that could be factored in the Asciidoc?

I'm also not sure who the comment is for? Is this the right abstraction level for the typical developer? If we comment anything, would it be the shape of e.g. result or row? An example JSON output or similar.

[simon-dew]

Thanks @maria-robobug , this is great. I've just cut them down slightly to save space. As @osfameron says if further explanation is needed it can go in the AsciiDoc.

[simon-dew]

I'm also not sure who the comment is for?

I would say, a developer who has a good knowledge of the language, and maybe some prior knowledge of traditional SQL, but is new to Couchbase and needs to know what are the methods, objects, or functions offered by the SDK.

[maria-robobug]

As @osfameron says if further explanation is needed it can go in the AsciiDoc.

Sounds good, just have some minor questions:

• When we say this should go in the AsciiDoc are we referring to pages in the docs-server repo?
• Or will we reference pages/partials from the docs-sdk-{insert-language-here} repos like we are doing with these code snippets?

[simon-dew]

When we say this should go in the AsciiDoc

I mean that these code snippets might be included anywhere. The including page should include the appropriate level of explanation. So in the docs server pages there might be more explanation; in the SDK pages there might be less.

[simon-dew]

I'm updating couchbase/docs-server#2249 to include a one- or two-line explanation of these code snippets that is (hopefully) appropriate for the developer how-to guide. I'll add you as a reviewer when it's ready @maria-robobug