docs: def create(gandi, resource, domain, duration, owner, admin, tech, bill,
             nameserver, extra_parameter, background):
      """Buy a domain."""
      if domain:
          gandi.echo('/!\ --domain option is deprecated and will be removed '
                     'upon next release.')
          gandi.echo("You should use 'gandi domain create %s' instead." % domain)
  
      if (domain and resource) and (domain != resource):
          gandi.echo('/!\ You specified both an option and an argument which '
                     'are different, please choose only one between: %s and %s.'
                     % (domain, resource))
          return
  
      _domain = domain or resource
      if not _domain:
          _domain = click.prompt('Name of the domain')
  
      result = gandi.domain.create(_domain, duration, owner, admin, tech, bill,
                                   nameserver, extra_parameter, background)
      if background:
          gandi.pretty_echo(result)
  
      return result