cargo vdev build component-docs should require argument and more helpful message printed in misuse

[jonathanpv]

Problem

The underlying ruby script running when calling cargo vdev build component-docs requires ARGV[0] to be the file path of the configuration schema:

if ARGV.empty?
  puts 'usage: extract-component-schema.rb <configuration schema path>'
  exit 1
end

# Ensure that Cue is present since we need it to import our intermediate JSON representation.
if @cue_binary_path.nil?
  puts 'Failed to find \'cue\' binary on the current path. Install \'cue\' (or make it available on the current path) and try again.'
  exit 1
end

schema_path = ARGV[0]
root_schema = JSON.parse(File.read(schema_path))

Currently we do not require any arguments when running this so the user must know before hand to pass in the file path. To prevent confusion we should add a required field, not utilize the script_wrapper macro, and provide a more helpful message than:

❯ cargo vdev build component-docs
usage: extract-component-schema.rb <configuration schema path>
Error: command: "/Users/jesse.szwedko/workspace/vector/scripts/generate-component-docs.rb"
  failed with exit code: 1

notice extract-component-schema.rb might confuse users since that is invoked when running cargo vdev buidl component-docs

Configuration

No response

Version

0.29.0

Debug Output

No response

Example Data

No response

Additional Context

No response

References

No response