chg [doc] Fix grammatical errors

pull/44/head
E. Cleopatra 2021-04-12 09:56:48 +01:00 committed by GitHub
parent cc2bea779b
commit cfbca156d8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 31 additions and 17 deletions

View File

@ -1,8 +1,10 @@
# Help, Support, and Forums # Help, Support, and Forums
Help and support for MISP is available from the [documentation](https://www.circl.lu/doc/misp/), [GitHub issues](https://github.com/MISP/MISP/issues), and [Gitter rooms](https://gitter.im/orgs/MISP/rooms) which are explained below. The MISP Project does not offer paid support services. Help and support for MISP is available from the [documentation](https://www.circl.lu/doc/misp/), [GitHub issues](https://github.com/MISP/MISP/issues), and [Gitter rooms](https://gitter.im/orgs/MISP/rooms) which are explained below.
The MISP Project does not offer paid support services.
If youre looking for known issues or would like to file a bug report, please see the [issue tracker](https://github.com/MISP/MISP/issues). These issues are constantly being updated and may contain workarounds for problems that youre experiencing, so its worth searching the issue tracker as a first step. If youre looking for known issues or would like to file a bug report, please see the [issue tracker](https://github.com/MISP/MISP/issues).
These issues are constantly being updated and may contain workarounds for problems that youre experiencing, so its worth searching the issue tracker as a first step.
## Staying safe ## Staying safe
@ -14,7 +16,8 @@ The MISP community includes people from all walks of life and from around the wo
Individuals differ in areas of experience and technical expertise. Individuals differ in areas of experience and technical expertise.
You will come into contact with others whose views and agendas differ from your own. You will come into contact with others whose views and agendas differ from your own.
Everyone is free to write what they please, as long as it doesnt violate our [Code of Conduct](https://github.com/MISP/MISP/blob/2.4/code_of_conduct.md). Everyone is free to write what they please, as long as it doesnt violate our [Code of Conduct](https://github.com/MISP/MISP/blob/2.4/code_of_conduct.md).
Be friendly and open, but do not believe everything you read. Use good judgment, and be especially careful when following instructions (e.g., sharing files) given by others on the lists. Be friendly and open, but do not believe everything you read.
Use good judgment, and be especially careful when following instructions (e.g., sharing files) given by others on the lists.
## Discussion guidelines ## Discussion guidelines
@ -25,31 +28,33 @@ Discussions also take place on GitHub issues.
Please do not send questions to individual MISP developers. Please do not send questions to individual MISP developers.
By sending messages to the appropriate rooms, you are not only giving others a chance to help you, but you may also be helping others by starting a public discussion about a shared problem or interest. By sending messages to the appropriate rooms, you are not only giving others a chance to help you, but you may also be helping others by starting a public discussion about a shared problem or interest.
These discussion venues are open places where people freely come together to discuss MISP and voluntarily help each other out of mutual interest and good will. These discussion venues are open places where people freely come together to discuss MISP and voluntarily help each other out of mutual interest and goodwill.
They are not your personal, paid support service. They are not your personal, paid support service.
No one owes you a reply or is obliged to help you solve your problems. No one owes you a reply or is obliged to help you solve your problems.
Nonetheless, there are many things you can do to make it more likely that you will receive a reply. Nonetheless, there are many things you can do to make it more likely that you will receive a reply.
The MISP community is fortunate to have a lot friendly and knowledgeable people who enjoy corresponding on these discussion channels The vast majority of them will be happy to help you if you follow these simple guidelines: The MISP community is fortunate to have a lot of friendly and knowledgeable people who enjoy corresponding on these discussion channels The vast majority of them will be happy to help you if you follow these simple guidelines:
- **Be polite and respectful:** Remember, no one here is obliged to reply to you. If you are rude and disrespectful, you are very likely to be ignored. - **Be polite and respectful:** Remember, no one here is obliged to reply to you. If you are rude and disrespectful, you are very likely to be ignored.
- **Be concise:** Include only essential information. If you ramble, it will be easier to skip over you and help someone else who gets right to the point. - **Be concise:** Include only essential information. If you ramble, it will be easier to skip over you and help someone else who gets right to the point.
- **Help us help you:** Tell us what youve already tried, and which documentation pages youve already read. Think of your readers. What essential information would they require in order to be able to help you? Make sure to include that information in your message. Read this article: [Ask questions the smart way](http://www.catb.org/~esr/faqs/smart-questions.html). - **Help us help you:** Tell us what youve already tried, and which documentation pages youve already read. Think of your readers. What essential information would they require to be able to help you? Make sure to include that information in your message. Read this article: [Ask questions the smart way](http://www.catb.org/~esr/faqs/smart-questions.html).
- **Be patient:** If it seems like your messages to the rooms are consistently being ignored, ensure youre following the guidelines above. If youre already doing so but still not getting any replies, then its likely that no one who knows the answer has had time to reply yet. Remember that the developers are very busy working on MISP, and can no answer every question. - **Be patient:** If it seems like your messages to the rooms are consistently being ignored, ensure youre following the guidelines above. If youre already doing so but still not getting any replies, then its likely that no one who knows the answer has had time to reply yet. Remember that the developers are very busy working on MISP, and can not answer every question.
- **Be a good community member:** As with any social community, members earn different reputations for themselves over time. Those who have shown themselves to be good community members through their past contributions have earned our good will, and we will be especially eager to help them and collaborate with them. If you are new to the community, you should understand that it may take time for you to earn the good will of others. This does not mean that you will not receive help. On the contrary, we are lucky to have a community that helps complete strangers, including many who post anonymously. You can read our projects [Code of Conduct](https://github.com/MISP/MISP/blob/2.4/code_of_conduct.md) for more information. - **Be a good community member:** As with any social community, members earn different reputations for themselves over time. Those who have shown themselves to be good community members through their past contributions have earned our goodwill, and we will be especially eager to help them and collaborate with them. If you are new to the community, you should understand that it may take time for you to earn the goodwill of others. This does not mean that you will not receive help. On the contrary, we are lucky to have a community that helps strangers, including many who post anonymously.
- **Report issues and submit changes in the right places:** The Gitter rooms are good places to ask questions and discuss things. However, if youre submitting a more formal report, wed prefer that you submit it to the appropriate GitHub issue tracker, so that it doesnt get overlooked. Likewise, if you see that something in the documentation should be changed, dont simply point it out in a discussion venue. Instead, [submit the change](https://github.com/MISP/misp-book/contributing.md). - **Report issues and submit changes in the right places:** The Gitter rooms are good places to ask questions and discuss things. However, if youre submitting a more formal report, wed prefer that you submit it to the appropriate GitHub issue tracker so that it doesnt get overlooked. Likewise, if you see that something in the documentation should be changed, dont simply point it out in a discussion venue. Instead, [submit the change](https://github.com/MISP/misp-book/contributing.md).
- **Moderation:** The moderation team aims to enforce our [Code of Conduct](https://github.com/MISP/MISP/blob/2.4/code_of_conduct.md). Beyond this, users should not expect any specific action from the moderation team. Specifically, users should not request that posts or messages be deleted or edited by a moderator. Users are reminded that, in most venues, anything posted will be sent out as an email to other others, and these emails cannot be deleted from others inboxes. - **Moderation:** The moderation team aims to enforce our [Code of Conduct](https://github.com/MISP/MISP/blob/2.4/code_of_conduct.md). Beyond this, users should not expect any specific action from the moderation team. Specifically, users should not request that posts or messages be deleted or edited by a moderator. Users are reminded that, in most venues, anything posted will be sent out as an email to others, and these emails cannot be deleted from others inboxes.
- **Suggestions:** We are generally open to hearing suggestions for new features. Our roadmap is based on requests from people who use MISP. However, it is rather unlikely that we will change our schedule in order to accommodate an individual request. If theres a particular feature youd like to see in MISP, a much more effective way to make it happen is to [contribute a patch]() that implements it. We happily accept such contributions, provided they meet our standards. Please note, however, that its always a good idea to field a discussion of your idea on the [MISP/MISP Gitter room](https://gitter.im/MISP/MISP) or by creating a GitHub issue before putting in a lot of hard work on something that we may not be able or willing to accept. - **Suggestions:** We are generally open to hearing suggestions for new features. Our roadmap is based on requests from people who use MISP. However, it is rather unlikely that we will change our schedule in order to accommodate an individual request. If theres a particular feature youd like to see in MISP, a much more effective way to make it happen is to [contribute a patch]() that implements it. We happily accept such contributions, provided they meet our standards. Please note, however, that its always a good idea to field a discussion of your idea on the [MISP/MISP Gitter room](https://gitter.im/MISP/MISP) or by creating a GitHub issue before putting in a lot of hard work on something that we may not be able or willing to accept.
## Gitter ## Gitter
This section covers each of our individual rooms, with details about the purpose of each list and how to use it. To join the room on Gitter, click the "Join" button at the bottom of the page. If you prefer, you can view all these rooms on Matrix by clicking the `[m]` button on the navigation bar. This section covers each of our rooms, with details about the purpose of each list and how to use it.
To join a room on Gitter, click the "Join" button at the bottom of the page.
If you prefer, you can view all these rooms on Matrix by clicking the `[m]` button on the navigation bar.
- **[MISP/MISP](https://gitter.im/MISP/MISP):** This room is meant for general MISP discussions, particularly for MISP developers and development-related questions. This room is primarily intended for people who are interested in contributing to MISP or who are willing to learn more about its implementation. Examples of topics and questions suitable for this room include: - **[MISP/MISP](https://gitter.im/MISP/MISP):** This room is meant for general MISP discussions, particularly for MISP developers and development-related questions. This room is primarily intended for people who are interested in contributing to MISP or who are willing to learn more about its implementation. Examples of topics and questions suitable for this room include:
- Questions about why we made certain implementation decisions. For example: “Why did you implement XYZ this way and not the other way?” - Questions about why we made certain implementation decisions. For example: “Why did you implement XYZ this way and not the other way?”
- Questions about code layout and where code is for certain functionality. - Questions about code layout and where code is for certain functionality.
- Discussions about proposed new features and patches. For example: “I would like to implement feature XYZ.” - Discussions about proposed new features and patches. For example: “I would like to implement feature XYZ.”
- Security discussions which are relevant to MISP in some way. - Security discussions that are relevant to MISP in some way.
- **[MISP/Support](https://gitter.im/MISP/Support):** This room is for helping users solve various daily problems with MISP. This is the ultimate support channel for all things MISP. Come prepared with log files if appropriate. Please try searching the archives of the channel before sending a question. In addition, please make sure that you have read and understood the [documentation](https://www.circl.lu/doc/misp/) prior to posting to the room. Examples of topics or questions suitable for this list include: - **[MISP/Support](https://gitter.im/MISP/Support):** This room is for helping users solve various daily problems with MISP. This is the ultimate support channel for all things MISP. Come prepared with log files if appropriate. Please try searching the archives of the channel before sending a question. Also, please make sure that you have read and understood the [documentation](https://www.circl.lu/doc/misp/) before posting it to the room. Examples of topics or questions suitable for this list include:
- Installation problems - Installation problems
- Questions of the form: “How do I…?” - Questions of the form: “How do I…?”
- **[MISP/Sharing](https://gitter.im/MISP/Sharing):** This channel is for general discussions on threat intelligence sharing topics. - **[MISP/Sharing](https://gitter.im/MISP/Sharing):** This channel is for general discussions on threat intelligence sharing topics.
@ -58,12 +63,21 @@ This section covers each of our individual rooms, with details about the purpose
## GitHub issues ## GitHub issues
You can also ask questions by creating an issue on the appropriate GitHub repo. In the MISP core repository, use the [Support issue template](https://github.com/MISP/MISP/blob/2.4/.github/ISSUE_TEMPLATE/support_request.md) when seeking support. You can also ask questions by creating an issue on the appropriate GitHub repo.
In the MISP core repository, use the [Support issue template](https://github.com/MISP/MISP/blob/2.4/.github/ISSUE_TEMPLATE/support_request.md) when seeking support.
To be clear, GitHub issues is not a replacement for the [MISP/Support](https://gitter.im/MISP/Support) room. This is simply an additional place for discussion. Certain types of discussions naturally lend themselves more to GitHub issues or to forums, and different types of users prefer different venues. Weve heard from some users who find the Gitter to be a bit intimidating or who may feel that their message may get lost in the thousands of messages. Others want more selective control over topic notifications. Some users simply appreciate the ability to add a “reaction” to a message instead of having to add an entirely new reply. Whatever your reasons, its up to you to decide where and how you want to join the conversation. To be clear, GitHub issues is not a replacement for the [MISP/Support](https://gitter.im/MISP/Support) room.
This is simply an additional place for discussion.
Certain types of discussions naturally lend themselves more to GitHub issues or forums, and different types of users prefer different venues.
Weve heard from some users who find the Gitter to be a bit intimidating or who may feel that their message may get lost in the thousands of messages.
Others want more selective control over topic notifications.
Whatever your reasons, its up to you to decide where and how you want to join the conversation.
## Social media ## Social media
The MISP Project has a presence on [Twitter (MISPProject)](https://twitter.com/MISPProject). MISP Project has a presence on [Twitter (@MISPProject)](https://twitter.com/MISPProject).
Generally speaking, this is not intended to be a primary support venue. (Those would be [MISP/Support Gitter room]() and the issue tracker.) Rather, these are primarily intended to be a way to more widely disseminate news related to MISP. If you use Twitter, you may find it convenient to follow the MISP Project there as a way of receiving MISP news. Generally speaking, this is not intended to be a primary support venue.
(Those would be [MISP/Support Gitter room]() and the issue tracker.)
Rather, these are primarily intended to be a way to more widely disseminate news related to MISP.
If you use Twitter, you may find it convenient to follow the MISP Project there as a way of receiving MISP news.