From: Shawn Routhier Date: Thu, 2 Jul 2015 06:15:50 +0000 (-0700) Subject: [3873] Fix typos X-Git-Tag: trac3921a_base~1^2~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f374d3819c740a3d5072e64ed0e5ee74c97cb7d1;p=thirdparty%2Fkea.git [3873] Fix typos --- diff --git a/doc/guide/faq.xml b/doc/guide/faq.xml index f216163472..3f3522cc26 100644 --- a/doc/guide/faq.xml +++ b/doc/guide/faq.xml @@ -23,7 +23,7 @@
Where did the Kea name came from? - Kea is a name of high mountain parrot living in New Zealand. + Kea is the name of a high mountain parrot living in New Zealand. See this for an extended answer. @@ -34,7 +34,7 @@ Kea is developed by a small team of engineers. Our resources are limited, so we need to prioritize requests. The complexity of a new - feature (how difficult is it to implement a feature and how likely it + feature (how difficult it is to implement a feature and how likely it would break something that already works), amount of work required and expected popularity (i.e. how many users would actually benefit from it) are three leading factors. We sometimes also have contractual obligations. @@ -44,43 +44,43 @@ implement features that are actively requested first, but the reality is that we have more requests than we can handle, so some of them must be postponed, at least in the near future. So is your request likely to - be reject? Not at all. You can do many things to greatly improve chances - of your request to be fulfilled. First, it helps to explain why you + be rejected? Not at all. You can do many things to greatly improve the + chances of your request being fulfilled. First, it helps to explain why you need a feature. If your explanation is reasonable and there are likely other users that would benefit from it, the chances for Kea developers to put this task on a roadmap is better. Saying that you are willing to participate in tests (e.g. test engineering drops when they become available) is also helpful. - Another thing you can do to greatly improve chances of a feature + Another thing you can do to greatly improve the chances of a feature to appear is to actually develop it on your own and submit a patch. - That's a venue that people often forget about. Kea is an open source + That's an avenue that people often forget about. Kea is open source software and we do accept patches. There are certain requirements, like code quality, comments, unit-tests, documentation, etc., but we have accepted a significant number of patches in the past, so it's doable. Accepted contributions range from minor documentation corrections to - significant new features, like support for new database type. Before + significant new features, like support for a new database type. Before considering writing and submitting a patch, make sure you read - Contributor's Guide in Kea Developer's Guide. + the Contributor's Guide in Kea Developer's Guide. - Kea is developed by ISC, which is non-profit organization. + Kea is developed by ISC, which is a non-profit organization. You may consider signing a development contract with us. In the past we did implement certain features due to contractual obligations. With additional funds we are able to put extra engineering efforts into Kea development. We can reshuffle our schedule or add extra - hands to the team if needed. Please keep in mind that Kea is an - open source software and its principal goal is to provide good DHCP + hands to the team if needed. Please keep in mind that Kea is + open source software and its principle goal is to provide a good DHCP solution that can be used by everyone. In other words, we may refuse a contract that would tie the solution to specific proprietary technology or make it unusable for other users. Also, we strive to make Kea a reference implementation, so if your proposal significantly - violates RFC, we may have a problem with that. Nevertheless, please + violates a RFC, we may have a problem with that. Nevertheless, please talk to us and we may be able to find a solution. Finally, Kea has a public roadmap, with releases happening several times each year. We tend - to not modify features for current milestone, unless there are very good + to not modify features for the current milestone, unless there are very good reasons to do so. Therefore "I'd like a featury X in 6 months" is much better received than "I'd like a feature X now".
@@ -91,20 +91,20 @@ Frequently Asked Questions about DHCPv4
- I set up a firewall, but Kea server still receives the traffic. Why? + I set up a firewall, but the Kea server still receives the traffic. Why? - Any DHCPv4 server must be able to receive from and send traffic to the + Any DHCPv4 server must be able to receive from and send traffic to hosts that don't have an IPv4 address assigned yet. That is typically not - possible with regular UDP sockets, therefore Kea DHCPv4 server uses raw + possible with regular UDP sockets, therefore the Kea DHCPv4 server uses raw sockets by default. Raw sockets mean that the incoming packets are received as raw Ethernet frames, thus bypassing the whole kernel IP stack, including any firewalling rules your kernel may provide. If you do not want the server to use raw sockets, it is possible to - config Kea DHCPv4 server to use UDP sockets instead. See dhcp-socket-type + configure the Kea DHCPv4 server to use UDP sockets instead. See dhcp-socket-type described in . However, - using UDP sockets have certain limitations. In particular, it may not allow - to send responses directly to the clients without IPv4 addresses assigned. + using UDP sockets has certain limitations. In particular, they may not allow + for sending responses directly to clients without IPv4 addresses assigned. That's ok, if all your traffic is coming through relay agents.