diff --git a/CHANGELOG.md b/CHANGELOG.md index 1c9d3a7..3b2d387 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,7 @@ - source-control: git status & multi-repo status - persistence: new section with structure and basic content - dev: set git attributes to correctly identify languages used +- practices: asking questions ### Changed diff --git a/docs/practices/discussions/asking-questions.md b/docs/practices/discussions/asking-questions.md new file mode 100644 index 0000000..8e18c3d --- /dev/null +++ b/docs/practices/discussions/asking-questions.md @@ -0,0 +1,46 @@ +# Asking Questions + +The way to get useful answers is to ask effective questions. + +The act of creating an effective question can often produce the answer without even needing to share the question with others (although it is valuable to still ask for a wider scope of answers). + +The act of creating a question allows for a clear analysis of what the problem is, what has been tried already. + + +!!! HINT "No need to apologies for asking" + People enjoy answering other peoples questions as it provides a sense of satisfaction that they could help. There is never a need to apologies that your are asking a question, especially if you think the answer should be obvious + +!!! HINT "There are no silly questions" + People are not born omnicient, they spend their lifetime learning on a unique path. No two people will understand all the same things in the same way, even when working in the same area. + + + +## Ask an Engineering question + +The more detailed an engineering question is, the more likely that an appropriate answer will be given. + +1. Convey the goal of your question (what are you trying to achieve) +2. Establish the facts as clearly as possible + - What steps did you try + - How does someone else reproduce this issue (create the simplest possible example) +3. Convey assumptions made +4. Examples, examples, examples +5. Review and refactor (remove unnecessary words and information, reread and rewrite to ensure the question is easy to understand) + +!!! WARNING "Fast questions take more time" + Asking questions with little or no thought leads to much more time spent explaining the question once its out there. + + +### Example questions + +Some example engineering questions (TODO: review questions in slack / stack exchange for useful, not so useful examples) + + + +## The Art of Asking Questions + +1. Demonstrate preparedness for the conversation +2. Illustrate your expertise without showing off +3. Invite others to deepen or broaden their thinking and challenge held beliefs + +[Article from the Harvard Business School](https://hbr.org/2022/05/the-art-of-asking-great-questions){target=_blank .md-button} diff --git a/mkdocs.yml b/mkdocs.yml index aca203e..35aaacc 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -219,6 +219,7 @@ nav: - practices/index.md - Discussions: - practices/discussions/index.md + - Asking Questions: practices/discussions/asking-questions.md - practices/discussions/rolling-wave-planning.md - practices/discussions/one-to-one-meeting.md - Retrospective: practices/discussions/retrospective.md