w3c_api 0.1.3 → 0.1.5

data/Rakefile

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-require 'rubocop/rake_task'
+require "rubocop/rake_task"
 
 RuboCop::RakeTask.new
 

data/demo/rate_limiting_demo.rb

@@ -0,0 +1,135 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/w3c_api"
+
+# Demo script to demonstrate rate limiting functionality
+puts "W3C API Rate Limiting Demo"
+puts "=" * 40
+
+puts "\nThis demo shows how to use the built-in rate limiting features"
+puts "of the W3C API client to handle API rate limits gracefully."
+
+# Create a client instance
+client = W3cApi::Client.new
+
+# Demo 1: Default rate limiting (enabled by default)
+puts "\n1. Default Rate Limiting Configuration:"
+puts "   - Max retries: 3"
+puts "   - Base delay: 1.0s"
+puts "   - Max delay: 60.0s"
+puts "   - Backoff factor: 2.0"
+
+begin
+  start_time = Time.now
+
+  puts "\n   Making API requests with default rate limiting..."
+
+  # Fetch specifications
+  specs = client.specifications(items: 3)
+  puts "   ✓ Retrieved #{specs.links.specifications.length} specifications"
+
+  # Fetch a specific specification
+  spec_detail = client.specification("html5")
+  puts "   ✓ Retrieved specification: #{spec_detail.title}"
+
+  end_time = Time.now
+  puts "   ⏱️  Total time: #{(end_time - start_time).round(2)}s"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+
+# Demo 2: Custom rate limiting configuration
+puts "\n2. Custom Rate Limiting Configuration:"
+puts "   Configuring more aggressive rate limiting for APIs with strict limits"
+
+begin
+  # Configure custom rate limiting
+  W3cApi::Hal.instance.configure_rate_limiting(
+    max_retries: 5,        # More retry attempts
+    base_delay: 0.5,       # Shorter initial delay
+    max_delay: 30.0,       # Lower maximum delay
+    backoff_factor: 1.5, # Gentler backoff
+  )
+
+  puts "   ✓ Rate limiting reconfigured"
+
+  start_time = Time.now
+
+  # Make requests with custom configuration
+  groups = client.groups(items: 3)
+  puts "   ✓ Retrieved #{groups.links.groups.length} groups"
+
+  end_time = Time.now
+  puts "   ⏱️  Total time: #{(end_time - start_time).round(2)}s"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+
+# Demo 3: Temporarily disable rate limiting
+puts "\n3. Temporarily Disabling Rate Limiting:"
+puts "   Useful for bulk operations where you control the rate manually"
+
+begin
+  # Disable rate limiting
+  W3cApi::Hal.instance.disable_rate_limiting
+  puts "   ✓ Rate limiting disabled"
+
+  start_time = Time.now
+
+  # Make requests without rate limiting
+  series = client.series(items: 3)
+  puts "   ✓ Retrieved #{series.links.series.length} series"
+
+  end_time = Time.now
+  puts "   ⏱️  Total time: #{(end_time - start_time).round(2)}s"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+
+# Demo 4: Re-enable rate limiting
+puts "\n4. Re-enabling Rate Limiting:"
+
+begin
+  # Re-enable rate limiting with default settings
+  W3cApi::Hal.instance.enable_rate_limiting
+  puts "   ✓ Rate limiting re-enabled with default settings"
+
+  start_time = Time.now
+
+  ecosystems = client.ecosystems
+  puts "   ✓ Retrieved #{ecosystems.links.ecosystems.length} ecosystems"
+
+  end_time = Time.now
+  puts "   ⏱️  Total time: #{(end_time - start_time).round(2)}s"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+
+# Demo 5: Check rate limiting status
+puts "\n5. Checking Rate Limiting Status:"
+
+if W3cApi::Hal.instance.rate_limiting_enabled?
+  puts "   ✓ Rate limiting is currently ENABLED"
+else
+  puts "   ⚠️  Rate limiting is currently DISABLED"
+end
+
+puts "\n#{'=' * 40}"
+puts "Rate Limiting Demo Completed! 🎉"
+
+puts "\n📚 Key Takeaways:"
+puts "• Rate limiting is enabled by default for reliable API access"
+puts "• You can customize retry behavior for different API requirements"
+puts "• Rate limiting can be temporarily disabled for bulk operations"
+puts "• The system automatically handles 429 and 5xx errors with exponential backoff"
+puts "• Retry-After headers from the server are automatically respected"
+
+puts "\n🔧 Common Use Cases:"
+puts "• Default settings work well for most applications"
+puts "• Increase max_retries for critical operations"
+puts "• Decrease delays for APIs with generous rate limits"
+puts "• Disable temporarily for bulk data processing"
+
+puts "\n📖 For more information, see the rate limiting documentation"
+puts "   in the lutaml-hal library or the W3C API documentation."

data/demo/test_embed_functionality.rb

@@ -0,0 +1,88 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require_relative "lib/w3c_api"
+
+def test_link_realization(groups_with_embed)
+  return unless groups_with_embed.respond_to?(:links) && groups_with_embed.links.respond_to?(:groups)
+
+  first_group_link = groups_with_embed.links.groups.first
+  return unless first_group_link
+
+  puts "   First group link: #{first_group_link.href}"
+  return unless first_group_link.respond_to?(:realize)
+
+  begin
+    realized_group = first_group_link.realize(parent_resource: groups_with_embed)
+    puts "   ✓ Link realization with embedded data successful"
+    puts "   Realized group name: #{realized_group.name if realized_group.respond_to?(:name)}"
+  rescue StandardError => e
+    puts "   ⚠ Link realization failed: #{e.message}"
+  end
+end
+
+puts "Testing W3C API Embed Functionality"
+puts "=" * 40
+
+# Initialize the client
+client = W3cApi::Client.new
+
+begin
+  puts "\n1. Testing Groups endpoint with embed..."
+  groups_with_embed = client.groups(embed: true, items: 5)
+
+  puts "   Response type: #{groups_with_embed.class}"
+  puts "   Has embedded content: #{groups_with_embed.respond_to?(:has_embedded?) && groups_with_embed.has_embedded?('groups')}"
+
+  if groups_with_embed.respond_to?(:has_embedded?) && groups_with_embed.has_embedded?("groups")
+    puts "   Available methods: #{groups_with_embed.methods.grep(/embed/).join(', ')}"
+
+    embedded_groups = groups_with_embed.get_embedded("groups")
+    puts "   Number of embedded groups: #{embedded_groups.length}"
+    puts "   First embedded group: #{embedded_groups.first['name'] if embedded_groups.first}"
+  end
+
+  puts "\n2. Testing Specifications endpoint with embed..."
+  specs_with_embed = client.specifications(embed: true, items: 5)
+
+  puts "   Response type: #{specs_with_embed.class}"
+  puts "   Has embedded content: #{specs_with_embed.respond_to?(:has_embedded?) && specs_with_embed.has_embedded?('specifications')}"
+
+  if specs_with_embed.respond_to?(:has_embedded?) && specs_with_embed.has_embedded?("specifications")
+    puts "   Available methods: #{specs_with_embed.methods.grep(/embed/).join(', ')}"
+
+    embedded_specs = specs_with_embed.get_embedded("specifications")
+    puts "   Number of embedded specifications: #{embedded_specs.length}"
+    puts "   First embedded spec: #{embedded_specs.first['title'] if embedded_specs.first}"
+  end
+
+  puts "\n3. Testing comparison: with vs without embed..."
+
+  # Without embed
+  start_time = Time.now
+  client.groups(items: 3)
+  without_embed_time = Time.now - start_time
+  puts "   Without embed: #{without_embed_time.round(3)}s"
+
+  # With embed
+  start_time = Time.now
+  groups_with_embed = client.groups(embed: true, items: 3)
+  with_embed_time = Time.now - start_time
+  puts "   With embed: #{with_embed_time.round(3)}s"
+
+  if groups_with_embed.respond_to?(:has_embedded?) && groups_with_embed.has_embedded?("groups")
+    puts "   ✓ Embed functionality working correctly!"
+  else
+    puts "   ⚠ Embed parameter accepted but no embedded content returned"
+  end
+
+  puts "\n4. Testing link realization with embedded content..."
+  test_link_realization(groups_with_embed)
+
+  puts "\n✅ Embed functionality test completed successfully!"
+rescue StandardError => e
+  puts "\n❌ Error during testing: #{e.message}"
+  puts "Backtrace:"
+  puts e.backtrace.first(5).join("\n")
+end

data/demo/test_improved_embed_functionality.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "stringio"
+require_relative "../lib/w3c_api"
+
+puts "=== W3C API Improved Embed Functionality Demo ==="
+puts
+
+# Test 1: List embed-supported endpoints
+puts "1. Testing embed-supported endpoints discovery:"
+supported_endpoints = W3cApi::Client.embed_supported_endpoints
+puts "   Embed-supported endpoints: #{supported_endpoints.join(', ')}"
+puts
+
+# Test 2: Check specific endpoint support
+puts "2. Testing specific endpoint embed support:"
+client = W3cApi::Client.new
+puts "   specifications supports embed: #{client.embed_supported?(:specification_index)}"
+puts "   groups supports embed: #{client.embed_supported?(:group_index)}"
+puts "   series supports embed: #{client.embed_supported?(:serie_index)}"
+puts "   specification_resource supports embed: #{client.embed_supported?(:specification_resource)}"
+puts
+
+# Test 3: Get embed information
+puts "3. Testing embed information:"
+embed_info = W3cApi::Embed.embed_info
+puts "   Supported endpoints: #{embed_info[:supported_endpoints].join(', ')}"
+puts "   Discovery: #{embed_info[:usage_example][:discovery]}"
+puts "   Usage: #{embed_info[:usage_example][:usage]}"
+puts "   Automatic realization: #{embed_info[:usage_example][:automatic_realization]}"
+puts
+
+# Test 4: Use Client methods with embed
+puts "4. Testing Client methods with embed parameter:"
+begin
+  puts "   Fetching specifications with embed=true..."
+  specs = client.specifications(embed: true, items: 2)
+  puts "   ✓ Successfully fetched #{specs.class}"
+
+  if specs.respond_to?(:embedded_data) && specs.embedded_data
+    puts "   ✓ Has embedded data: #{specs.embedded_data.keys.join(', ')}"
+  else
+    puts "   ⚠ No embedded data found"
+  end
+
+  # Test automatic embedded content detection
+  if specs.links.respond_to?(:specifications) && specs.links.specifications.any?
+    puts "   Testing automatic embedded content detection..."
+    first_spec_link = specs.links.specifications.first
+
+    begin
+      # This should automatically use embedded content without parent_resource parameter
+      spec = first_spec_link.realize
+      puts "   ✓ Successfully realized specification automatically"
+      puts "   ✓ Specification class: #{spec.class}"
+      puts "   ✓ Specification title: #{spec.title}" if spec.respond_to?(:title)
+    rescue StandardError => e
+      puts "   ✗ Error realizing specification: #{e.message}"
+    end
+  end
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+puts
+
+# Test 5: Test Embed module information methods
+puts "5. Testing Embed module information methods:"
+begin
+  puts "   Testing supported_endpoints method..."
+  supported = W3cApi::Embed.supported_endpoints
+  puts "   ✓ Supported endpoints: #{supported.join(', ')}"
+
+  puts "   Testing supports_embed? method..."
+  puts "   ✓ specifications supports embed: #{W3cApi::Embed.supports_embed?(:specification_index)}"
+  puts "   ✓ groups supports embed: #{W3cApi::Embed.supports_embed?(:group_index)}"
+
+  puts "   Testing endpoint_descriptions method..."
+  descriptions = W3cApi::Embed.endpoint_descriptions
+  puts "   ✓ Available descriptions: #{descriptions.keys.join(', ')}"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+puts
+
+puts "=== Demo completed ==="
+puts "Summary of improvements:"
+puts "• ✓ Added embed-supported endpoints discovery methods"
+puts "• ✓ Client methods now support embed parameter directly"
+puts "• ✓ Automatic embedded content detection (no parent_resource needed)"
+puts "• ✓ Enhanced Embed module with information methods"
+puts "• ✓ Removed deprecated code for cleaner API"

data/examples/rate_limiting_stress_test.rb

@@ -0,0 +1,239 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/w3c_api"
+
+# Advanced example: Rate limiting stress test and performance analysis
+puts "W3C API Rate Limiting - Advanced Stress Test Example"
+puts "=" * 55
+
+puts "\nThis example demonstrates advanced rate limiting scenarios:"
+puts "• Rapid sequential requests"
+puts "• Performance analysis across different endpoints"
+puts "• Dynamic configuration changes"
+puts "• Load testing patterns"
+
+# Create a client instance
+client = W3cApi::Client.new
+
+# Configure aggressive rate limiting for testing
+W3cApi::Hal.instance.configure_rate_limiting(
+  max_retries: 3,
+  base_delay: 0.1,      # Very short delay for testing
+  max_delay: 5.0,       # Lower max delay
+  backoff_factor: 2.0,
+)
+
+puts "\n🔧 Rate limiting configuration for stress testing:"
+puts "   - Max retries: 3"
+puts "   - Base delay: 0.1s (very aggressive)"
+puts "   - Max delay: 5.0s"
+puts "   - Backoff factor: 2.0"
+
+# Test 1: Rapid sequential requests
+puts "\n1. 🚀 Rapid Sequential Requests Test:"
+puts "   Making 10 rapid requests to analyze rate limiting behavior..."
+
+start_time = Time.now
+successful_requests = 0
+failed_requests = 0
+request_times = []
+
+10.times do |i|
+  print "   Request #{i + 1}: "
+  request_start = Time.now
+
+  begin
+    specs = client.specifications(items: 1)
+    request_time = (Time.now - request_start).round(3)
+    request_times << request_time
+    puts "✓ Success (#{specs.links.specifications.length} items, #{request_time}s)"
+    successful_requests += 1
+  rescue StandardError => e
+    request_time = (Time.now - request_start).round(3)
+    request_times << request_time
+    puts "✗ Failed: #{e.message} (#{request_time}s)"
+    failed_requests += 1
+  end
+end
+
+end_time = Time.now
+total_time = (end_time - start_time).round(2)
+
+puts "\n   📊 Performance Analysis:"
+puts "   - Successful requests: #{successful_requests}"
+puts "   - Failed requests: #{failed_requests}"
+puts "   - Total time: #{total_time}s"
+puts "   - Average time per request: #{(total_time / 10).round(3)}s"
+puts "   - Fastest request: #{request_times.min}s"
+puts "   - Slowest request: #{request_times.max}s"
+
+# Test 2: Cross-endpoint performance analysis
+puts "\n2. 🎯 Cross-Endpoint Performance Analysis:"
+endpoints = [
+  { name: "specifications", method: :specifications,
+    link_key: :specifications },
+  { name: "groups", method: :groups, link_key: :groups },
+  { name: "series", method: :series, link_key: :series },
+  { name: "ecosystems", method: :ecosystems, link_key: :ecosystems },
+]
+
+endpoint_results = {}
+
+endpoints.each do |endpoint|
+  print "   Testing #{endpoint[:name].ljust(15)}: "
+  start = Time.now
+
+  begin
+    result = client.send(endpoint[:method], items: 2)
+    duration = (Time.now - start).round(3)
+    count = result.links.send(endpoint[:link_key]).length
+
+    endpoint_results[endpoint[:name]] = {
+      success: true,
+      duration: duration,
+      count: count,
+    }
+
+    puts "✓ Success (#{count} items, #{duration}s)"
+  rescue StandardError => e
+    duration = (Time.now - start).round(3)
+    endpoint_results[endpoint[:name]] = {
+      success: false,
+      duration: duration,
+      error: e.message,
+    }
+    puts "✗ Failed: #{e.message} (#{duration}s)"
+  end
+end
+
+puts "\n   📈 Endpoint Performance Summary:"
+endpoint_results.each do |name, result|
+  if result[:success]
+    puts "   - #{name.ljust(15)}: #{result[:duration]}s (#{result[:count]} items)"
+  else
+    puts "   - #{name.ljust(15)}: #{result[:duration]}s (FAILED)"
+  end
+end
+
+# Test 3: Dynamic configuration testing
+puts "\n3. ⚙️  Dynamic Configuration Testing:"
+
+begin
+  puts "   Testing with rate limiting enabled..."
+  start = Time.now
+  client.specifications(items: 1)
+  time1 = (Time.now - start).round(3)
+  puts "   ✓ Request 1 (enabled): #{time1}s"
+
+  puts "   🔄 Disabling rate limiting..."
+  W3cApi::Hal.instance.disable_rate_limiting
+
+  start = Time.now
+  client.specifications(items: 1)
+  time2 = (Time.now - start).round(3)
+  puts "   ✓ Request 2 (disabled): #{time2}s"
+
+  puts "   🔄 Re-enabling with different configuration..."
+  W3cApi::Hal.instance.enable_rate_limiting
+  W3cApi::Hal.instance.configure_rate_limiting(
+    max_retries: 5,
+    base_delay: 0.2,
+    max_delay: 10.0,
+    backoff_factor: 1.5,
+  )
+
+  start = Time.now
+  client.specifications(items: 1)
+  time3 = (Time.now - start).round(3)
+  puts "   ✓ Request 3 (reconfigured): #{time3}s"
+
+  puts "\n   ⏱️  Timing Comparison:"
+  puts "   - Enabled (default):  #{time1}s"
+  puts "   - Disabled:           #{time2}s"
+  puts "   - Reconfigured:       #{time3}s"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+
+# Test 4: Bulk operation simulation
+puts "\n4. 📦 Bulk Operation Simulation:"
+puts "   Simulating a bulk data collection scenario..."
+
+bulk_start = Time.now
+bulk_results = []
+
+# Simulate collecting data from multiple endpoints
+bulk_operations = [
+  { name: "Collect specifications", method: :specifications, items: 3 },
+  { name: "Collect groups", method: :groups, items: 2 },
+  { name: "Collect series", method: :series, items: 2 },
+]
+
+bulk_operations.each_with_index do |operation, _index|
+  print "   #{operation[:name]}: "
+  op_start = Time.now
+
+  begin
+    result = client.send(operation[:method], items: operation[:items])
+    duration = (Time.now - op_start).round(3)
+
+    case operation[:method]
+    when :specifications
+      count = result.links.specifications.length
+    when :groups
+      count = result.links.groups.length
+    when :series
+      count = result.links.series.length
+    end
+
+    bulk_results << { success: true, duration: duration, count: count }
+    puts "✓ #{count} items (#{duration}s)"
+
+    # Add a small delay between bulk operations
+    sleep(0.1)
+  rescue StandardError => e
+    duration = (Time.now - op_start).round(3)
+    bulk_results << { success: false, duration: duration }
+    puts "✗ Failed: #{e.message} (#{duration}s)"
+  end
+end
+
+bulk_total_time = (Time.now - bulk_start).round(2)
+successful_ops = bulk_results.count { |r| r[:success] }
+total_items = bulk_results.select { |r| r[:success] }.sum { |r| r[:count] || 0 }
+
+puts "\n   📊 Bulk Operation Results:"
+puts "   - Total time: #{bulk_total_time}s"
+puts "   - Successful operations: #{successful_ops}/#{bulk_operations.length}"
+puts "   - Total items collected: #{total_items}"
+puts "   - Average time per operation: #{(bulk_total_time / bulk_operations.length).round(3)}s"
+
+puts "\n#{'=' * 55}"
+puts "🎉 Advanced Stress Test Completed!"
+
+puts "\n📋 Test Summary:"
+puts "• Sequential requests: #{successful_requests}/10 successful"
+puts "• Endpoint tests: #{endpoint_results.count do |_, r|
+  r[:success]
+end}/#{endpoints.length} successful"
+puts "• Configuration changes: Applied successfully"
+puts "• Bulk operations: #{successful_ops}/#{bulk_operations.length} successful"
+
+puts "\n💡 Key Insights:"
+puts "• Rate limiting maintains API stability under load"
+puts "• Configuration changes take effect immediately"
+puts "• Different endpoints may have varying response times"
+puts "• Bulk operations benefit from rate limiting protection"
+
+puts "\n🔍 In Production Scenarios:"
+puts "• Rate limiting prevents API abuse and ensures fair usage"
+puts "• Exponential backoff reduces server load during high traffic"
+puts "• Retry-After headers are automatically respected"
+puts "• 429 and 5xx errors are handled gracefully with retries"
+
+puts "\n📚 Advanced Usage Tips:"
+puts "• Monitor request patterns to optimize rate limiting settings"
+puts "• Use bulk operations with manual delays for large datasets"
+puts "• Adjust configuration based on API documentation"
+puts "• Consider disabling rate limiting for controlled bulk operations"

data/exe/w3c_api

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'w3c_api'
+require "w3c_api"
 
 W3cApi::Cli.start(ARGV)

data/lib/w3c_api/cli.rb

@@ -1,45 +1,46 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'commands/specification'
-require_relative 'commands/specification_version'
-require_relative 'commands/group'
-require_relative 'commands/user'
-require_relative 'commands/translation'
-require_relative 'commands/ecosystem'
-require_relative 'commands/series'
-require_relative 'commands/affiliation'
-require_relative 'commands/participation'
+require "thor"
+require_relative "commands/specification"
+require_relative "commands/specification_version"
+require_relative "commands/group"
+require_relative "commands/user"
+require_relative "commands/translation"
+require_relative "commands/ecosystem"
+require_relative "commands/series"
+require_relative "commands/affiliation"
+require_relative "commands/participation"
 
 module W3cApi
   # Main CLI class that registers all subcommands
   class Cli < Thor
     # Register subcommands
-    desc 'specification SUBCOMMAND ...ARGS', 'Work with W3C specifications'
-    subcommand 'specification', Commands::Specification
+    desc "specification SUBCOMMAND ...ARGS", "Work with W3C specifications"
+    subcommand "specification", Commands::Specification
 
-    desc 'specification_version SUBCOMMAND ...ARGS', 'Work with W3C specification versions'
-    subcommand 'specification_version', Commands::SpecificationVersion
+    desc "specification_version SUBCOMMAND ...ARGS",
+         "Work with W3C specification versions"
+    subcommand "specification_version", Commands::SpecificationVersion
 
-    desc 'group SUBCOMMAND ...ARGS', 'Work with W3C groups'
-    subcommand 'group', Commands::Group
+    desc "group SUBCOMMAND ...ARGS", "Work with W3C groups"
+    subcommand "group", Commands::Group
 
-    desc 'user SUBCOMMAND ...ARGS', 'Work with W3C users'
-    subcommand 'user', Commands::User
+    desc "user SUBCOMMAND ...ARGS", "Work with W3C users"
+    subcommand "user", Commands::User
 
-    desc 'translation SUBCOMMAND ...ARGS', 'Work with W3C translations'
-    subcommand 'translation', Commands::Translation
+    desc "translation SUBCOMMAND ...ARGS", "Work with W3C translations"
+    subcommand "translation", Commands::Translation
 
-    desc 'ecosystem SUBCOMMAND ...ARGS', 'Work with W3C ecosystems'
-    subcommand 'ecosystem', Commands::Ecosystem
+    desc "ecosystem SUBCOMMAND ...ARGS", "Work with W3C ecosystems"
+    subcommand "ecosystem", Commands::Ecosystem
 
-    desc 'series SUBCOMMAND ...ARGS', 'Work with W3C specification series'
-    subcommand 'series', Commands::Series
+    desc "series SUBCOMMAND ...ARGS", "Work with W3C specification series"
+    subcommand "series", Commands::Series
 
-    desc 'affiliation SUBCOMMAND ...ARGS', 'Work with W3C affiliations'
-    subcommand 'affiliation', Commands::Affiliation
+    desc "affiliation SUBCOMMAND ...ARGS", "Work with W3C affiliations"
+    subcommand "affiliation", Commands::Affiliation
 
-    desc 'participation SUBCOMMAND ...ARGS', 'Work with W3C participations'
-    subcommand 'participation', Commands::Participation
+    desc "participation SUBCOMMAND ...ARGS", "Work with W3C participations"
+    subcommand "participation", Commands::Participation
   end
 end