Skip to content

docs: create comprehensive documentation suite#11

Merged
rianjs merged 2 commits intomainfrom
docs/comprehensive-documentation
Jan 13, 2026
Merged

docs: create comprehensive documentation suite#11
rianjs merged 2 commits intomainfrom
docs/comprehensive-documentation

Conversation

@rianjs
Copy link
Copy Markdown
Collaborator

@rianjs rianjs commented Jan 13, 2026

Summary

  • Complete rewrite of README.md as exhaustive API reference with all commands, flags, examples, and scripting guidance
  • New CLAUDE.md for AI agent guidance (architecture, patterns, workflows)
  • New CONTRIBUTING.md for developer onboarding
  • New docs/integration-tests.md with manual verification checklist

Changes

File Description
README.md Rewritten (~778 lines) - full command reference, output examples, scripting, Go library usage
CLAUDE.md New (~200 lines) - AI agent guide with architecture and patterns
CONTRIBUTING.md New (~280 lines) - developer setup, code style, PR process
docs/integration-tests.md New (~350 lines) - manual test matrix for all commands

Acceptance Criteria

  • README covers 100% of CLI commands
  • All examples are copy-paste runnable
  • CLAUDE.md enables AI agents to build/test/lint autonomously
  • CONTRIBUTING.md enables new developer setup in <10 minutes
  • Integration tests cover all commands and output formats

Test plan

  • make build succeeds
  • make test passes
  • Manual review of documentation accuracy

Closes #2


Generated with Claude Code

rianjs and others added 2 commits January 13, 2026 06:43
This restructures the codebase from a flat cmd/ layout to a modular,
testable architecture with proper separation of concerns.

Changes:
- Create public api/ package with types, errors, and domain-specific files
- Create internal/cmd/ with Options pattern for all commands
- Create internal/view/ for output formatting (table/json/plain)
- Create internal/version/ for build-time version injection
- Rename internal/keychain/ to internal/config/
- Move entry point to cmd/newrelic-cli/main.go
- Replace --json flag with --output/-o (table|json|plain)
- Add --no-color global flag
- Update Makefile with new targets and ldflags
- Add unit tests for view, version, and api packages

The new structure enables:
- Testable commands via Options struct and injectable clients
- Public API package that can be imported by other Go projects
- Consistent output formatting across all commands
- Better separation between CLI, business logic, and API

Closes #1

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- README.md: Complete rewrite with exhaustive command reference,
  configuration details, scripting examples, and Go library usage
- CLAUDE.md: AI agent guidance document with architecture, patterns,
  and workflows
- CONTRIBUTING.md: Developer onboarding guide with setup, style,
  and contribution process
- docs/integration-tests.md: Manual verification checklist for all
  commands and edge cases

Closes #2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@rianjs rianjs requested a review from piekstra January 13, 2026 11:53
@rianjs rianjs merged commit f0e80ea into main Jan 13, 2026
1 check passed
@rianjs rianjs deleted the docs/comprehensive-documentation branch January 13, 2026 14:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Create comprehensive documentation suite

2 participants