Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Not an issue #7

Closed
jasonmacdonald opened this issue Aug 17, 2017 · 1 comment
Closed

Not an issue #7

jasonmacdonald opened this issue Aug 17, 2017 · 1 comment
Labels

Comments

@jasonmacdonald
Copy link

Like others, I just found my way here from ESdoc issues and I simply cannot comprehend how uncooperative that maintainer is. I'm so glad you "put your money where your mouth is" and actually forked/improved it! I can't wait to switch over!!!

Once I get my head wrapped around your new project I'll try to help out where I can. Great job! Please let me know if there are any areas you'd like specific help in.

Feel free to delete this, just wanted to say thanks and offer my help, if I can.

@typhonrt
Copy link
Member

typhonrt commented Aug 17, 2017

@jasonmacdonald welcome and thanks for the nod!

Indeed the architecture differs somewhat from ESDoc and I'll definitely be creating an overview covering the details especially 3rd party plugin integration though that will be coming just before official launch, so there may be a bit of head scratching until these resources are available.

An impetus for TJSDoc besides creating a production quality tool is to support the many module / repo vs mono repo approach. All other doc tooling only works well with mono repos. TJSDoc itself is highly modular and uses the eventbus pattern for inter-module communication via a plugin system and there are over 90 event bindings exposed in the core system accessible by any 1st / 3rd party plugin during the runtime which may be hard to follow currently. I'll be creating a plugin which documents this pattern along with interactive D3 graphs showing control flow of how modules are connected via events across modules which will significantly help in understanding how things work. IE by creating stellar documentation for TJSDoc itself the goal of supporting the many repo approach will be achieved, so a bit self-referential by design. 😄

I did just post an update in the refactoring thread about current status, but right now I'm the bottleneck in getting the publisher module completed and checked in.

I'll close this issue, but do follow #2 for ongoing updates. It'd be great to have you as an early user when the initial alpha release is ready as I'd like to do a round of wider testing before publicly announcing availability.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants