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

Generate better API documentation #6599

Merged
merged 1 commit into from
Nov 12, 2015
Merged

Generate better API documentation #6599

merged 1 commit into from
Nov 12, 2015

Conversation

ManasJayanth
Copy link
Contributor

/cc @yurydelendik @brendandahl

Initiating a thread discussing ways to improving the docs and feedback for the same.
Starting with missing comments on the API docs page

/re #6526


return PDFDocumentLoadingTask;
})();
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unneeded code change -- please revert tabulation back.

@yurydelendik
Copy link
Contributor

Nice!

Can you also fix double entry of PDFDocumentLoadingTask (see http://107.22.172.223:8877/824a96518b07a1c/api/draft/PDFDocumentLoadingTask.html)? Interesting that PDFDocumentProxy (see http://107.22.172.223:8877/824a96518b07a1c/api/draft/PDFDocumentProxy.html) has no such issue.

@timvandermeij
Copy link
Contributor

I agree, this is looking much better now! Fortunately the update to JSDoc 3.3.3 also included a better lay-out, so it is more pleasant to look at too.

@ManasJayanth
Copy link
Contributor Author

@timvandermeij Update JSDoc for PDFJS too?

@timvandermeij
Copy link
Contributor

No, we already use JCDoc 3.3.3 as can be seen on the last text line of http://107.22.172.223:8877/824a96518b07a1c/api/draft/PDFDocumentLoadingTask.html. I just meant to say that the general look of the documentation has improved with that update from recently. No need to do any updates, sorry for the confusion :)

@ManasJayanth
Copy link
Contributor Author

@timvandermeij Oh! I thought you were referring to the version in package.json which is 3.3.0-alpha9 Thank you :)

Anyways, about adding more examples within the docs, how do I get started?

*/
var PDFDocumentLoadingTask = (function PDFDocumentLoadingTaskClosure() {
/** @constructs PDFDocumentLoadingTask */
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you remove other @constructs in this file too?

@ManasJayanth
Copy link
Contributor Author

Back to how it was before along with the fix

@timvandermeij
Copy link
Contributor

/botio-linux preview

@pdfjsbot
Copy link

From: Bot.io (Linux)


Received

Command cmd_preview from @timvandermeij received. Current queue size: 0

Live output at: http://107.21.233.14:8877/c13b9829bfbe380/output.txt

@yurydelendik
Copy link
Contributor

Looks good. Thank you for the patch.

yurydelendik added a commit that referenced this pull request Nov 12, 2015
@yurydelendik yurydelendik merged commit 7381ff9 into mozilla:master Nov 12, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants