This wiki has undergone a migration to Confluence found Here
Difference between revisions of "FHIR Rules for asking questions"
Jump to navigation
Jump to search
(Created page with "Many members of the FHIR community generously give their time for free, answering other implementer's questions on various social media forums. Some of the forums in which F...") |
|||
| (7 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | This page has been migrated to Confluence here: https://confluence.hl7.org/display/FHIR/FHIR+Rules+for+Asking+Questions | ||
| + | |||
Many members of the FHIR community generously give their time for free, answering other implementer's questions on various social media forums. | Many members of the FHIR community generously give their time for free, answering other implementer's questions on various social media forums. | ||
Some of the forums in which FHIR Community Members are regularly available: | Some of the forums in which FHIR Community Members are regularly available: | ||
| − | * | + | * [http://chat.fhir.org chat.fhir.org] |
| − | * | + | * [http://community.fhir.org community.fhir.org] |
| − | * | + | * [http://stackoverflow.com stackoverflow.com] |
| − | * the [ | + | * the [http://wiki.hl7.org/index.php?title=FHIR_email_list_subscription_instructions FHIR email list] |
| − | Please note, however, that this is all | + | Please note, however, that this is all provided by volunteers. |
| − | # | + | If you're going to ask a question, please take note of the following guidelines: |
| − | # | + | # Be specific - provide enough information for someone who might answer the question to actually do so |
| + | # Be clear - what are you asking for? | ||
# Don't ask questions that can be characterised as 'please do my homework for me' - you'll get better answers when when your question is very focused | # Don't ask questions that can be characterised as 'please do my homework for me' - you'll get better answers when when your question is very focused | ||
| − | # answer | + | # Show that you've done a bit of work yourself - indicate what you've read or where you've already looked (at minimum, reading or searching the specification and searching chat.fhir.org is encouraged) |
| + | # Please don't ask questions on multiple forums at once. Just ask on one, and wait at least a business day before trying another one. Someone usually responds more quickly than that, but all of us have a life | ||
| + | |||
| + | By the same token, responding to others who ask questions is encouraged. You don't need to be an "expert" or a member of any particular work group. Answering questions is a good way to build credibility within the community and to give back. That said, there are some guidelines here too: | ||
| + | # Only answer questions when you're relatively confident that you know the answer to | ||
| + | # Try to distinguish when you're asserting fact vs. opinion | ||
| + | # If you're not completely confident in the answer, don't be afraid to indicate that | ||
| + | # When possible, provide references into the specification or other authoritative specification to back up what you're saying | ||
| + | # If someone asking a question has identified an area where the specification is unclear or could be improved, encourage them to submit a change request - this helps broaden the pool of those who are working to improve the specification and also increases a sense of ownership | ||
| + | |||
| + | See also [http://stackoverflow.com/help/how-to-ask Stack Overflow Question Guidelines] | ||
| − | + | == Why are you here? == | |
| − | + | Mostly, you'll end up at this page if someone referred you here. That means that they think your question (or maybe your response) didn't meet these guidelines. That doesn't mean you can't ask the question or respond, but it does mean you might want to try harder to not take the service for granted. | |
Latest revision as of 16:20, 13 February 2020
This page has been migrated to Confluence here: https://confluence.hl7.org/display/FHIR/FHIR+Rules+for+Asking+Questions
Many members of the FHIR community generously give their time for free, answering other implementer's questions on various social media forums.
Some of the forums in which FHIR Community Members are regularly available:
Please note, however, that this is all provided by volunteers.
If you're going to ask a question, please take note of the following guidelines:
- Be specific - provide enough information for someone who might answer the question to actually do so
- Be clear - what are you asking for?
- Don't ask questions that can be characterised as 'please do my homework for me' - you'll get better answers when when your question is very focused
- Show that you've done a bit of work yourself - indicate what you've read or where you've already looked (at minimum, reading or searching the specification and searching chat.fhir.org is encouraged)
- Please don't ask questions on multiple forums at once. Just ask on one, and wait at least a business day before trying another one. Someone usually responds more quickly than that, but all of us have a life
By the same token, responding to others who ask questions is encouraged. You don't need to be an "expert" or a member of any particular work group. Answering questions is a good way to build credibility within the community and to give back. That said, there are some guidelines here too:
- Only answer questions when you're relatively confident that you know the answer to
- Try to distinguish when you're asserting fact vs. opinion
- If you're not completely confident in the answer, don't be afraid to indicate that
- When possible, provide references into the specification or other authoritative specification to back up what you're saying
- If someone asking a question has identified an area where the specification is unclear or could be improved, encourage them to submit a change request - this helps broaden the pool of those who are working to improve the specification and also increases a sense of ownership
See also Stack Overflow Question Guidelines
Why are you here?
Mostly, you'll end up at this page if someone referred you here. That means that they think your question (or maybe your response) didn't meet these guidelines. That doesn't mean you can't ask the question or respond, but it does mean you might want to try harder to not take the service for granted.
