Skip to content
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

(WIP) Docs: Update readme #18

Merged
merged 5 commits into from
Feb 20, 2018
Merged

(WIP) Docs: Update readme #18

merged 5 commits into from
Feb 20, 2018

Conversation

KSerrania
Copy link
Collaborator

  • Add description of the project
  • Update app setup to reflect current state of the project
  • Add contribution guidelines

@oxlay @Gandem could you help me with wording / rephrasing for better clarity?

@Gandem
Copy link
Owner

Gandem commented Feb 16, 2018

I'll add my suggestions in a review so we can further discuss the wording !

README.md Outdated
@@ -1,5 +1,13 @@
# bonjour-reflector

## About this project

This projects aims to make bonjour devices (such as printers, chromecasts, ...) discoverable and usable by other devices located in different VLANs.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd add something about how this is similar to avahi-reflector, but in addition permits a fine-grained control of how Bonjour traffic is reflected between VLANs.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And this project* typo

README.md Outdated

This projects aims to make bonjour devices (such as printers, chromecasts, ...) discoverable and usable by other devices located in different VLANs.

This is done by intercepting mDNS packets and forwarding them to the correct VLANs (for the request packets, the VLANs where the bonjour devices are located; for the response packets, the VLANs where the searching devices are located).
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's split this in bullet points to make it clearer maybe ?

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we also add a sentence about how this interception is done ? (the bonjour-reflector should have on interface with all the concerned vlans on tagged for example)

@anatolebeuzon
Copy link
Collaborator

I reorganized a few bits in the README. Feel free to discuss these changes if you think the README could be improved :)

Copy link
Owner

@Gandem Gandem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM overall thanks !

@Gandem Gandem merged commit 35c26ac into master Feb 20, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants