Enhance `deno doc` result

[afaur]

• Make sure names show up in deno doc command.
• Add mod entry points
  • Don't have to have these but..
  • mod.ts in lib/util simplifies main.ts and mod.ts by making them not change if files get added to util.
  • mod.ts in lib allows main.ts and mod.ts to have less duplication.
  • Maybe main.ts should be removed from root directory to use mod.ts as other Deno projects seem to do?
  • main.ts and mod.ts in the root directory are exactly the same right now.
  • If both are kept, maybe one should only export the Main object that contains server and router?
    • Doing this might provide a slimmer entry point (less imports), but I am not really sure how important that is.

Update:

• Possible alterations (https://github.com/afaur/pogo/commit/248d692c1bcca8ea1b11986ab6465130dce17eca).
  • Rename lib/mod.ts to lib/main.ts
    • This file does not really function as a mod here.
    • This might be a good change to make.
  • Remove main.ts and fix tests
    • Probably not a good decision since users of the library would have to change imports.
  • Change mod.ts in the root to a one line export
    • deno doc stops showing the main entry point from the output with this change.
    • This might be okay.
    • The object/class that main provides, contains server and router functions.
      • Outside of the object/class they have their own entries in deno doc.

[afaur]

• Update: Got tired of waiting for github to show all the commits here.
  • I rebased all changes since last review and that got them to show up.

As for mod.ts vs main.ts - yeah, I went against the Deno community's convention on naming this file...

• I removed the mod.ts files since main.ts is the public entry point for pogo.

I'm relatively new to TypeScript and still trying to get a good feel for what should be public vs private.

• Initially I thought it would be good to expose everything, but now changed it to what the user should know about.
• I wasn't able to get Request and Response exposed in a way for deno doc to annotate them.
• I think this might be possible, but may require an interface for them that gets added to types.ts?

I'm willing to have a mod.ts alias for people who expect it or tools that make assumptions about it

• The mod.ts probably comes from the mod.rs in rust.

Should add in a follow up PR:

• deno doc badge to the top of the readme
• jsdoc strings at the top of exported items.

[sholladay]

Sorry about the merge conflicts. I moved some things around while implementing h.directory(). If you could fix the conflict and remove the toolkit interface, in favor of exposing the class like you had it earlier, this will be ready to merge.

[afaur]

No problem. I was able to merge master into this today, and the changes were easy to resolve. I removed the interfaces that I added to types, and then added tookit, request, and response as exports from main. I think this will allow for jsdoc strings on everything that is currently listed here (https://github.com/sholladay/pogo#api).

[sholladay]

This is looking great. I'll try it out when I get to a terminal. Aiming to merge this tonight.