Skip to content

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

Open
1 task done
reactive-firewall opened this issue May 27, 2025 · 2 comments · May be fixed by #429
Open
1 task done

Related updates to the FAQ to point to new documentation #425

reactive-firewall opened this issue May 27, 2025 · 2 comments · May be fixed by #429
Assignees
Labels
Chore Miscellaneous chores to maintain the project documentation Improvements or additions to documentation question Further information is requested

Comments

@reactive-firewall
Copy link
Owner

reactive-firewall commented May 27, 2025

Followup chore

Chore

  • add related questions to the FAQ to point readers to the new documentation
@reactive-firewall reactive-firewall self-assigned this May 27, 2025
@reactive-firewall reactive-firewall added documentation Improvements or additions to documentation question Further information is requested BLOCKED ⚠︎ Unable to proceed at this time and removed BLOCKED ⚠︎ Unable to proceed at this time labels May 27, 2025
@reactive-firewall
Copy link
Owner Author

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.
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
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.
For example:

  • Network errors: Check your network settings and firewall rules.
  • Value errors: Ensure you are providing valid arguments to multicast API calls.
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.

---
  • TODO: fix the links

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.
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.

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.

---

@reactive-firewall
Copy link
Owner Author

what about security?

# 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.

@reactive-firewall reactive-firewall moved this from To do to In progress in Multicast Project Jun 3, 2025
@reactive-firewall reactive-firewall added the Chore Miscellaneous chores to maintain the project label Jun 3, 2025
reactive-firewall added a commit that referenced this issue Jun 4, 2025
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
@reactive-firewall reactive-firewall linked a pull request Jun 4, 2025 that will close this issue
1 task
@reactive-firewall reactive-firewall linked a pull request Jun 4, 2025 that will close this issue
1 task
reactive-firewall added a commit that referenced this issue Jun 4, 2025
…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
reactive-firewall added a commit that referenced this issue Jun 4, 2025
…-)

Changes in file docs/FAQ.md:
 * style fixes

Changes in file docs/USAGE.md:
 * minor reworking of header orginization
 * minor reworking of header style
@reactive-firewall reactive-firewall moved this from In progress to Resolved in Multicast Project Jun 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Chore Miscellaneous chores to maintain the project documentation Improvements or additions to documentation question Further information is requested
Projects
Status: Resolved
Development

Successfully merging a pull request may close this issue.

1 participant