Skip to content

Improve App initialization error logs + docs#1250

Merged
srajiang merged 3 commits intoslackapi:mainfrom
srajiang:app-init-logging
Jan 20, 2022
Merged

Improve App initialization error logs + docs#1250
srajiang merged 3 commits intoslackapi:mainfrom
srajiang:app-init-logging

Conversation

@srajiang
Copy link
Contributor

@srajiang srajiang commented Dec 18, 2021

Summary

  • Improves App initialization error case logging
  • Adds links to relevant documentation for better troubleshooting
  • Tweaks OAuth documentation to specify required oauth installer options.
  • Additions to help improve code readability make maintaining easier

Test

  • Easiest way would be to use npm link these changes to one of your sample apps and try out different combos of App options.

Requirements (place an x in each [ ])

@srajiang srajiang self-assigned this Dec 18, 2021
@srajiang srajiang added the enhancement M-T: A feature request for new functionality label Dec 18, 2021
@srajiang srajiang added this to the 3.9.0 milestone Dec 18, 2021
@codecov
Copy link

codecov bot commented Dec 18, 2021

Codecov Report

Merging #1250 (990cd48) into main (2a97007) will not change coverage.
The diff coverage is 77.77%.

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #1250   +/-   ##
=======================================
  Coverage   73.22%   73.22%           
=======================================
  Files          17       17           
  Lines        1438     1438           
  Branches      431      431           
=======================================
  Hits         1053     1053           
  Misses        300      300           
  Partials       85       85           
Impacted Files Coverage Δ
src/App.ts 85.05% <77.77%> (ø)

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 2a97007...990cd48. Read the comment docs.

Copy link
Contributor

@seratch seratch left a comment

Choose a reason for hiding this comment

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

Left one comment about the change on the boolean test part. All other changes sound great 👍

Comment on lines +12 to +13
* `clientId`, `clientSecret`, `stateSecret` and `scopes` (required)
* An `installationStore` option with `storeInstallation` and `fetchInstallation` handlers defined for storing installation data to a database *(optional, but highly recommended for production)*
Copy link
Member

Choose a reason for hiding this comment

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

Nice improvement on clarity. I always appreciate when arguments are explicitly "required" or "optional"

Copy link
Contributor

@filmaj filmaj left a comment

Choose a reason for hiding this comment

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

Sorry I'm late to the party here! Agree with the comments here, there are a few small tweaks left to some of the wording and error messaging that would improve this PR. That being said, thanks for putting the time into making these changes - already a huge improvement over what was there before!

@srajiang srajiang merged commit a3a612c into slackapi:main Jan 20, 2022
@srajiang srajiang deleted the app-init-logging branch January 20, 2022 07:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement M-T: A feature request for new functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants