Skip to content

chore(jsdoc): add jsdoc to parts of logging system#3180

Merged
rwaskiewicz merged 3 commits intomainfrom
rwaskiewicz/document-logging
Jan 4, 2022
Merged

chore(jsdoc): add jsdoc to parts of logging system#3180
rwaskiewicz merged 3 commits intomainfrom
rwaskiewicz/document-logging

Conversation

@rwaskiewicz
Copy link
Copy Markdown
Member

Pull request checklist

Please check if your PR fulfills the following requirements:

  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been reviewed and added / updated if needed (for bug fixes / features)
  • Build (npm run build) was run locally and any changes were pushed
  • Unit tests (npm test) were run locally and passed
  • E2E Tests (npm run test.karma.prod) were run locally and passed
  • Prettier (npm run prettier) was run locally and passed

Pull request type

Please check the type of change your PR introduces:

  • Bugfix
  • Feature
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • Documentation content changes
  • Other (please describe):

What is the current behavior?

There is no JSDoc for our logging infra

GitHub Issue Number: N/A

What is the new behavior?

this commit adds JSDoc to a portion of Stencil's logging infrastructure.
it was motivated by a spike wherein investigating adding error codes to
the compiler were explored. this work is recovered from that effort, to
help aid in understanability of this portion of the codebase.

some methods have been renamed to better reflect their intent.

some usages of var have been converted to let, as usage of the
variable defined using var did not appear to need to be declared using
the keyword

Does this introduce a breaking change?

  • Yes
  • No

Testing

N/A, although I was actively using this system with the intent of getting error messages out

this commit adds JSDoc to a portion of Stencil's logging infrastructure.
it was motivated by a spike wherein investigating adding error codes to
the compiler were explored. this work is recovered from that effort, to
help aid in understanability of this portion of the codebase.

some methods have been renamed to better reflect their intent.

some usages of `var` have been converted to `let`, as usage of the
variable defined using `var` did not appear to need to be declared using
the keyword
@rwaskiewicz rwaskiewicz requested a review from a team December 10, 2021 15:07
@rwaskiewicz rwaskiewicz merged commit 8d066f7 into main Jan 4, 2022
@rwaskiewicz rwaskiewicz deleted the rwaskiewicz/document-logging branch February 4, 2022 17:42
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.

2 participants