Modernize gem + documentation.

Author: ioquatix

config/sus.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2025, by Samuel Williams.
 
 require "covered/sus"
 include Covered::Sus

examples/fortune/server.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2014, by Samuel Williams.
+# Copyright, 2014-2025, by Samuel Williams.
 # Copyright, 2014, by Peter M. Goldstein.
 
 require "rubydns"

examples/wikipedia/server.rb

@@ -1,6 +1,9 @@
 #!/usr/bin/env ruby
 # encoding: utf-8
-# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2014-2025, by Samuel Williams.
+# Copyright, 2014, by Peter M. Goldstein.
 
 # Released under the MIT License.
 # Copyright, 2014-2022, by Samuel Williams.

gems.rb

@@ -1,15 +1,18 @@
 # frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2012-2025, by Samuel Williams.
+
 source "https://rubygems.org"
 
 gemspec
 
 group :maintenance, optional: true do
+	gem "bake-gem"
 	gem "bake-modernize"
-end
-
-group :development do
-	gem "process-daemon"
-	gem "nio4r"
+	gem "bake-releases"
+	
+	gem "utopia-project"
 end
 
 group :test do

guides/getting-started/readme.md

@@ -0,0 +1,63 @@
+# Getting Started
+
+This guide explains how to get started running your own DNS server with RubyDNS.
+
+## Installation
+
+Create a new directory for your project, with a gemfile, and then add the gem to your project:
+
+~~~ bash
+$ bundle add rubydns
+~~~
+
+## Usage
+
+### Simple DNS Server
+
+This example demonstrates how to create a simple DNS server that responds to `test.local A` and forwards all other requests to the system default resolver.
+
+``` ruby
+#!/usr/bin/env ruby
+require 'rubydns'
+
+# Use the system default resolver for upstream queries:
+upstream = Async::DNS::Resolver.default
+
+# We will use port 5300 so we don't need to run the server as root:
+endpoint = Async::DNS::Endpoint.for("localhost", port: 5300)
+
+# Start the RubyDNS server:
+RubyDNS.run(endpoint) do
+	match(%r{test.local}, Resolv::DNS::Resource::IN::A) do |transaction|
+		transaction.respond!("10.0.0.80")
+	end
+
+	# Default DNS handler
+	otherwise do |transaction|
+		transaction.passthrough!(upstream)
+	end
+end
+```
+
+### Custom Servers
+
+It is possible to create and integrate your own custom servers, however this functionality has now moved to [`Async::DNS::Server`](https://github.com/socketry/async-dns).
+
+``` ruby
+class MyServer < Async::DNS::Server
+	def process(name, resource_class, transaction)
+		transaction.fail!(:NXDomain)
+	end
+end
+
+Async do
+	task = MyServer.new.run
+	
+	# ... do other things, e.g. run specs/tests
+	
+	# Shut down the server manually if required, otherwise it will run indefinitely.
+	# task.stop
+end
+```
+
+This is the best way to integrate with other projects.

guides/links.yaml

@@ -0,0 +1,2 @@
+getting-started:
+  order: 0

lib/rubydns.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2009-2017, by Samuel Williams.
+# Copyright, 2009-2025, by Samuel Williams.
 # Copyright, 2014, by Peter M. Goldstein.
 
 require "async/dns"

lib/rubydns/rule.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2009-2017, by Samuel Williams.
+# Copyright, 2009-2025, by Samuel Williams.
 # Copyright, 2011, by Genki Sugawara.
 # Copyright, 2014, by Zac Sprackett.
 # Copyright, 2015, by Michal Cichra.

lib/rubydns/server.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2009-2017, by Samuel Williams.
+# Copyright, 2009-2025, by Samuel Williams.
 # Copyright, 2011, by Genki Sugawara.
 # Copyright, 2014, by Zac Sprackett.
 # Copyright, 2015, by Michal Cichra.

lib/rubydns/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2009-2018, by Samuel Williams.
+# Copyright, 2009-2025, by Samuel Williams.
 
 module RubyDNS
 	VERSION = "2.0.2"