<!--
title: Example documentation standards
domain: cloud-infra
topic: Documentation
language: Ruby
source: aws/aws-sdk-js
updated: 2015-07-22
url: https://awesomereviewers.com/reviewers/aws-sdk-js-example-documentation-standards/
-->

Organize API documentation examples for maximum clarity and usefulness. Place hand-written examples before generated examples since they're typically more valuable to users. When using @example tags, include only the descriptive title without redundant 'Example:' prefixes.

For instance:
```ruby
# Good
@example Custom implementation
  # Hand-written example here
@example Calling the operation
  # Generated example here

# Avoid
@example Example: Custom implementation
  # Example here
```

This approach improves readability and maintains consistent documentation style.