contributing

How can I contribute to the FAQ?

This FAQ is a GitHub project: PoshCode/PowerShellFAQ. Please note all contributions are under the cc-by-sa license.

How do I add a new question and answer?

Make a pull request to PoshCode/PowerShellFAQ, adding a file in one of the sub-folders of "src" with your question and it's answer.

Note that for the "book" version on PoshCode.org/PowerShellFAQ you must add the question as a link in the SUMMARY.md.

Can I add a question without an answer?

To add a question without an answer, use the GitHub issues. We can't guarantee that all of these will be added, because sometimes answers are just too complicated for our format...

What makes a good FAQ entry?

Any frequently asked question that can be summarized in a single sentence, and answered in one or two paragraphs. Because of limitations on some of the clients that these questions are asked on, we need each paragraph to be under 450 characters in length. If you must, you can provide multiple paragraphs, or hyperlinks to additional content.

Can I just suggest an improvement to the answer for a question?

You can! Feel free to submit a pull request to PoshCode/PowerShellFAQ with better answers, or to just open an issue and we'll take care of it. We welcome your contributions, whether it's new questions, corrections, updates, or suggestions for better answers!