dgeni icon indicating copy to clipboard operation
dgeni copied to clipboard

Simplification Wish List

Open tommck opened this issue 7 years ago • 2 comments

I'm dying to have setting up dgeni be a better experience. Every time I go in to change anything, it seems to break things. I only had it partially working in the past and now that I've ported my code to TypeScript, it's all not working now.

I really wish this was more of a "drop in" solution and included things like:

  • a default configuration that supports all angularjs constructs (directives, components, services, providers, etc)
  • a default set of navigable templates to render the docs.
  • a simple configuration object with things like "title", etc.
  • consistent parsing across JavaScript and TypeScript
  • a simpler customization experience

In general, nothing else I use in my whole dev ecosystem works like dgeni. I find myself constantly digging through source code to try to figure out why things don't work (links to things are dead/have bad paths, etc.)

I hope this doesn't come across too whiny, but I really like having auto-generated docs, but I always spend an inordinate amount of time just trying to get dgeni configured

tommck avatar Feb 28 '17 16:02 tommck

This is all totally doable. It just needs someone with some time on their hands to put it together :-/

petebacondarwin avatar Feb 28 '17 16:02 petebacondarwin

If I understood the project more, I would try it out, but I am usually completely lost when I try to configure dgeni

tommck avatar Feb 28 '17 16:02 tommck