Updated maintainer_guide

[WilliamBergamin]

Summary

Updated the maintainers guide, this should help developer more clearly understand how to build the project and run the tests. This should also help push the project towards using a bash approach to building and running the test as implemented in the bolt python project.

What was done:

• Clarified how to initially install the dependencies and run all the unit tests
• Replaced the python setup.py commands with their corresponding bash script commands
• Added distinction between the 2 different types of documentation that can be generated

Category (place an x in each of the [ ])

• slack_sdk.web.WebClient (sync/async) (Web API client)
• slack_sdk.webhook.WebhookClient (sync/async) (Incoming Webhook, response_url sender)
• slack_sdk.socket_mode (Socket Mode client)
• slack_sdk.signature (Request Signature Verifier)
• slack_sdk.oauth (OAuth Flow Utilities)
• slack_sdk.models (UI component builders)
• slack_sdk.scim (SCIM API client)
• slack_sdk.audit_logs (Audit Logs API client)
• slack_sdk.rtm_v2 (RTM client)
• /docs-src (Documents, have you run ./scripts/docs.sh?)
• /docs-src-v2 (Documents, have you run ./scripts/docs-v2.sh?)
• /tutorial (PythOnBoardingBot tutorial)
• tests/integration_tests (Automated tests for this library)
• miscellaneous documentation

Requirements (place an x in each [ ])

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.
• I've run python3 -m venv .venv && source .venv/bin/activate && ./scripts/run_validation.sh after making the changes.

[codecov]

Codecov Report

Merging #1225 (573e502) into main (c9dc6aa) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #1225   +/-   ##
=======================================
  Coverage   86.54%   86.54%           
=======================================
  Files         111      111           
  Lines       10943    10943           
=======================================
  Hits         9471     9471           
  Misses       1472     1472           

---

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 c9dc6aa...573e502. Read the comment docs.

[seratch]

Thanks for updating this! Once you resolves my comments, you can merge this PR (don't forget squashing commits into one!)

[filmaj]

Looks pretty good to me, left a couple of comments just to clarify a few final things. Thanks for improving this!

[filmaj]

LGTM! merge away!

[seratch]

LGTM - thanks for updating this!