Fix semconv template files (#1312)

* fix links

* fix

* fix template

* fix template further

* add generated resource file

* fix the doc comments

Author: lalitb

opentelemetry-semantic-conventions/scripts/generate-consts-from-spec.sh

@@ -43,6 +43,9 @@ docker run --rm \
 	--parameters conventions=resource
 
 # Keep `SCHEMA_URL` key in sync with spec version
-sed -i '' "s/\(opentelemetry.io\/schemas\/\)[^\"]*\"/\1$SPEC_VERSION\"/" src/lib.rs
+sed -i "s/\(opentelemetry.io\/schemas\/\)[^\"]*\"/\1$SPEC_VERSION\"/" src/lib.rs
+
+# handle doc generation failures
+sed -i 's/\[2\]\.$//' src/resource.rs # remove trailing [2] from few of the doc comments
 
 cargo fmt

opentelemetry-semantic-conventions/scripts/templates/header_resource.rs

@@ -3,16 +3,16 @@
 //! The [resource semantic conventions] define a set of standardized attributes
 //! to be used in `Resource`s.
 //!
-//! [resource semantic conventions]: https://github.com/open-telemetry/opentelemetry-specification/tree/master/specification/resource/semantic_conventions
+//! [resource semantic conventions]: https://github.com/open-telemetry/semantic-conventions/tree/main/model/resource
 //!
 //! ## Usage
 //!
 //! ```
-//! use opentelemetry::sdk;
+//! use opentelemetry_sdk::{trace::{config, TracerProvider}, Resource};
 //! use opentelemetry_semantic_conventions as semconv;
 //!
-//! let _tracer = sdk::trace::TracerProvider::builder()
-//!     .with_config(sdk::trace::config().with_resource(sdk::Resource::new(vec![
+//! let _tracer = TracerProvider::builder()
+//!     .with_config(config().with_resource(Resource::new(vec![
 //!         semconv::resource::SERVICE_NAME.string("my-service"),
 //!         semconv::resource::SERVICE_NAMESPACE.string("my-namespace"),
 //!     ])))

opentelemetry-semantic-conventions/scripts/templates/header_trace.rs

@@ -3,7 +3,7 @@
 //! The [trace semantic conventions] define a set of standardized attributes to
 //! be used in `Span`s.
 //!
-//! [trace semantic conventions]: https://github.com/open-telemetry/opentelemetry-specification/tree/master/specification/trace/semantic_conventions
+//! [trace semantic conventions]: https://github.com/open-telemetry/semantic-conventions/tree/main/model/trace
 //!
 //! ## Usage
 //!

opentelemetry-semantic-conventions/src/resource.rs

@@ -9,7 +9,7 @@
 //! The [resource semantic conventions] define a set of standardized attributes
 //! to be used in `Resource`s.
 //!
-//! [resource semantic conventions]: https://github.com/open-telemetry/opentelemetry-specification/tree/master/specification/resource/semantic_conventions
+//! [resource semantic conventions]: https://github.com/open-telemetry/semantic-conventions/tree/main/model/resource
 //!
 //! ## Usage
 //!
@@ -99,7 +99,7 @@ pub const CLOUD_REGION: Key = Key::from_static_str("cloud.region");
 /// * **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
 ///   Take care not to use the "invoked ARN" directly but replace any
 ///   [alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)
-///   with the resolved function version, as the same runtime instance may be invocable with
+///   with the resolved function version, as the same runtime instance may be invokable with
 ///   multiple different aliases.
 /// * **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
 /// * **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/en-us/rest/api/resources/resources/get-by-id) of the invoked function,

opentelemetry-semantic-conventions/src/trace.rs

@@ -9,7 +9,7 @@
 //! The [trace semantic conventions] define a set of standardized attributes to
 //! be used in `Span`s.
 //!
-//! [trace semantic conventions]: https://github.com/open-telemetry/opentelemetry-specification/tree/master/specification/trace/semantic_conventions
+//! [trace semantic conventions]: https://github.com/open-telemetry/semantic-conventions/tree/main/model/trace
 //!
 //! ## Usage
 //!