-
Notifications
You must be signed in to change notification settings - Fork 2
Related updates to the FAQ to point to new documentation #425
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
Sample Q&A to add to FAQ: How do I configure my environment for multicast development?To configure your environment for developing with the multicast library, follow the steps in the Install Guide.
Implementation draft### How do I configure my environment for multicast development?
To configure your environment for developing with the multicast library, follow the steps in the [Install Guide](https://github.com/reactive-firewall/multicast/tree/HEAD/docs/INSTALL.md).
Key steps include:
1. Ensuring you have a supported version of Python installed.
2. use pip to install
3. in python: `import multicast`; in bash: `python3 -m multicast --help`
--- What should I do if I encounter a specific exception while using the multicast library?If you encounter an exception, consult the troubleshooting guide. This guide lists common exceptions, their causes, and recommended solutions.
Implementation draft### How do I configure my environment for multicast development?
### What should I do if I encounter a specific exception while using the multicast library?
If you encounter an exception, consult the troubleshooting guide. This guide lists common exceptions, their causes, and recommended solutions.
For example:
* socket errors: Consult _python socket docs_. Check your network settings and firewall rules.
* Value errors: Ensure you are providing valid arguments to [multicast API](api/multicast/) calls.
---
How do I run and interpret the test suite for this project?To run the test suite, follow the instructions in the Testing Guide. The guide explains test organization, and how to run tests outside CI/CD. Implementation draft### How do I run and interpret the test suite for this project?
To run the test suite, follow the instructions in the [Testing Guide](https://github.com/reactive-firewall/multicast/tree/HEAD/docs/Testing.md).
The guide explains test organization, and how to run tests outside CI/CD.
--- How is continuous integration (CI) set up for this repository?CI is configured as described in the CI Guide. Automated builds and tests are run via GitHub Actions. Implementation draft### How is continuous integration (CI) set up for this repository?
CI is configured as described in the [CI Guide](https://github.com/reactive-firewall/multicast/tree/HEAD/docs/CI.md).
Key points:
Automated builds and tests are run via GitHub Actions.
Each pull request is tested for compatibility and code quality.
The guide details the CI workflow files, environment variables, and what to expect when contributing changes.
--- |
# Security
If you find a significant vulnerability, or evidence of one,
please report it privately.
We prefer that you use the [GitHub mechanism for privately reporting a vulnerability](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability#privately-reporting-a-security-vulnerability). Under the
[main repository's security tab](https://github.com/reactive-firewall/multicast/security), click "Report a vulnerability" to open the advisory form. |
Additions with file docs/INSTALL.md: * initial draft of INSTALL guide Additions with file docs/SECURITY.md: * minimal Draft for SECURITY Changes in file docs/FAQ.md: * various improvements
…on (- WIP #425 -) Changes in file docs/FAQ.md: * style fixes Changes in file docs/SECURITY.md: * style fixes for very long lines Changes in file docs/USAGE.md: * more white-space style fixes * related style fixes
…-) Changes in file docs/FAQ.md: * style fixes Changes in file docs/USAGE.md: * minor reworking of header orginization * minor reworking of header style
Uh oh!
There was an error while loading. Please reload this page.
Followup chore
Chore
The text was updated successfully, but these errors were encountered: