Skip to content

WRITEME: example is quietly omitted when it has no snippet tags in the first excerpt #6716

Open
@Laren-AWS

Description

@Laren-AWS

When an example has no snippet tags in the first excerpt, it is quietly omitted from the README.

For example, in this Java metadata, the first excerpt is only a description, which is valid. WRITEME detects the example has having no snippets and emits a subtle and rather cryptic warning and quietly omits the example from the output.

    Java:
      versions:
        - sdk_version: 2
          github: javav2/example_code/s3
          sdkguide:
          excerpts:
            - description: Generate a pre-signed URL for an object, then download it (GET request).
            - description: Imports.
              snippet_tags:
                - presigned.java2.generatepresignedgeturlandretrieve.import
            - description: Generate the URL.
              snippet_tags:
                - presigned.java2.generatepresignedgeturlandretrieve.createpresignedurl

Expected

WRITEME digs deeper into the excerpts to find a snippet tag so it can include the example.

Metadata

Metadata

Assignees

Labels

InternalTo help track internal tickets in a single location.ToolsThis issue relates to a custom tooling to streamline development tasks

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions