Skip to content

Comments

feature/typedoc: ready for auto generate typescript documentation#71

Closed
RSginer wants to merge 5 commits intojvandemo:masterfrom
RSginer:feature/typedoc
Closed

feature/typedoc: ready for auto generate typescript documentation#71
RSginer wants to merge 5 commits intojvandemo:masterfrom
RSginer:feature/typedoc

Conversation

@RSginer
Copy link
Contributor

@RSginer RSginer commented Apr 22, 2017

I think this feature is very interesting for all libraries. I added a gulp task for generate typescript docs, i am using this on my library project: https://ngbat.github.io/robin-ui/docs/

@jvandemo
Copy link
Owner

@RSginer — Thank you for you PR, much appreciated!

I really like the feature, but as mentioned in #70, we must think about how many people will use this feature vs the fact that it adds a lot of new dependencies, which makes npm install take longer when someone generates a new library.

If others are interested in having the feature, I am definitely open to adding it.

So I would suggest that others add a comment to this PR if they wish to have this included, so that we can merge this PR if there is enough interest.

Meanwhile, we could put up a wiki page with guidelines on how to generate docs using typedoc and gulp.

So if you could provide the guidelines in a written text, that would be awesome.

Thanks again for your efforts! 👍

@RSginer
Copy link
Contributor Author

RSginer commented Apr 22, 2017

Maybe you want to create branch for this if is not instersting by default. Anyway i will create a guide in the wiki. Nice work!

@tonivj5
Copy link

tonivj5 commented Apr 23, 2017

I think it is a main feature for a library. The most of libraries have and need docs 👍

@jdjuan
Copy link
Collaborator

jdjuan commented Apr 24, 2017

I also agree. It can be a great plus for this generator if it has documentation out of the box

@RSginer
Copy link
Contributor Author

RSginer commented Apr 24, 2017

I have been researching and maybe it is better to generate the documentation with compodoc ` I could implement it in the project if it is more interesting comment about it please

@jvandemo
Copy link
Owner

@RSginer — I had a look at both and I think compodoc is a better fit. The resulting documentation is more relevant since it is aimed at Angular code.

Do you want to create a PR for it or do you want me to add it?

Thanks again for your help! 👍

@jvandemo
Copy link
Owner

FYI, the command to run compodoc would be:

$ ./node_modules/.bin/compodoc src -p src/tsconfig.es5.json -s

@RSginer
Copy link
Contributor Author

RSginer commented Apr 25, 2017

Thanks i want to send a PR :) Give me a day to prepare it and i can implement compodoc. Thanks again for the command

@jvandemo
Copy link
Owner

@RSginer — Awesome, if you need help, just shout 👍

@RSginer RSginer closed this Apr 25, 2017
@RSginer
Copy link
Contributor Author

RSginer commented Apr 25, 2017

Closed in favor of #76

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants