doc: Collection objects has no property documents

[Milly]

Problem

These collection objects has no property documents.

• as
• is

Expected

Add documents.

Additional

Tried to fix in #89, but closed.

[lambdalisue]

I talked with Deno's member (@kt3k). He said that we need to do Copy & Paste the docs at least for now.

denoland/deno_doc#140

[Milly]

I think it would be better to implement auto-generation.

[lambdalisue]

Yes. I was wondering that as well.

[lambdalisue]

Unfortunately, generation doesn't help the situation.

#106 (comment)

[Milly]

Other ideas, generates like:

type AsCollection = {
  /** Annotate the ... */
  Optional: typeof asOptional;
  // ...
};

export const as: AsCollection = {
  Optional: asOptional,
  // ...
};

Or:

export const as: {
  /** Annotate the ... */
  Optional: typeof asOptional;
  // ...
} = {
  Optional: asOptional,
  // ...
};

[lambdalisue]

The 2nd one works like a charm 🎉