GitHub wording

[zonemaker.git] / README.rst

diff --git a/README.rst b/README.rst
index 128bee6e4d70df968c3bacdbed954faf6e02a1a3..b0a3f5b31813904c0d29729f6e26a6a7434180b5 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -1,5 +1,5 @@
-zonemaker: Write your DNS zone files in Python
-==============================================
+zonemaker: Python DNS zone files
+================================
 
 Introduction
 ------------
@@ -9,13 +9,13 @@ This is zonemaker_, a tool to generate DNS zone files from Python.
 The plain zone file format is pretty limited. There are not even variables, so 
 in many cases IP addresses and other data has to be repeated several times. 
 zonemaker is an attempt to provide more flexibility, by allowing you to write 
-your zones in Python. Hence all the usuel fatures, like variables, macros (aka 
-functions) and loops, are available to generate DNS zone data. At the same time, 
-zonemaker is reasonably simple and close to the actual structure of a DNS 
-zonefile, so it is suited for small setups. The output of zonemaker is a 
-standard zonefile, so it can be used with any DNS server supporting those.
+your zones in Python. Hence all the usuel fatures, like variables, macros (also 
+known as functions) and loops, are available to generate DNS zone data. At the 
+same time, zonemaker is reasonably simple and close to the actual structure of a 
+DNS zonefile, so it is suited for small setups. The output of zonemaker is a 
+standard zonefile, it can be used with any DNS server supporting those.
 
-.. _dyn-nsupdate: https://www.ralfj.de/projects/zonemaker
+.. _zonemaker: https://www.ralfj.de/projects/zonemaker
 
 Usage
 -----
@@ -23,15 +23,18 @@ Usage
 Simply call ``zonemaker`` with the zone python file as argument. The result will 
 be printed to stdout. See ``db.example.com.py`` for a sample file demonstrating 
 the use of the interface. ``Makefile.sample`` shows how a makefile which first 
-updates the zone, and then tells BIND to reload, could look like.
+updates the zone(s), and then tells BIND to reload, could look like.
 
 Source, License
 ---------------
 
-You can find the sources in the `git repository`_. They are provided under a 
-2-clause BSD license.
+You can find the sources in the `git repository`_ (also available `on GitHub`_). 
+They are provided under a `2-clause BSD license`_. See the file ``LICENSE-BSD`` 
+for more details.
 
 .. _git repository: http://www.ralfj.de/git/zonemaker.git
+.. _on GitHub: https://github.com/RalfJung/zonemaker
+.. _2-clause BSD license: http://opensource.org/licenses/bsd-license.php
 
 Contact
 -------