Skip to content

Conversation

@asmacdo
Copy link
Member

@asmacdo asmacdo commented Jan 16, 2026

Closes #338

Copilot AI review requested due to automatic review settings January 16, 2026 18:13
@asmacdo asmacdo added the semver-documentation Changes only affect the documentation label Jan 16, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive documentation for the --log-level option by providing a dedicated "Log Levels" section with usage guidance and practical examples. This addresses issue #338 by making it easier for users to understand when and how to use different log levels.

Changes:

  • Renamed "Command Reference" heading to "Reference" for brevity
  • Added "Log Levels" section with a table describing when to use each level
  • Provided three concrete examples showing INFO (default), NONE, and DEBUG output

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@codecov
Copy link

codecov bot commented Jan 16, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.69%. Comparing base (f35633e) to head (23fe39a).
⚠️ Report is 39 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #369      +/-   ##
==========================================
+ Coverage   91.38%   91.69%   +0.31%     
==========================================
  Files           8       15       +7     
  Lines        1056     1120      +64     
  Branches      138      139       +1     
==========================================
+ Hits          965     1027      +62     
- Misses         69       70       +1     
- Partials       22       23       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@asmacdo asmacdo requested a review from CodyCBakerPhD February 2, 2026 18:11
README.md Outdated
Control duct's verbosity with `--log-level` (or `DUCT_LOG_LEVEL` environment variable):

| Level | Use when... |
|-------|-------------|
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Recommendation: decide on alignment style

E.g.

Suggested change
|-------|-------------|
|:-------:|:-------------:|

aligns to center

Currently

Image

doesn't look quite as good as it 'could'

Up to you though

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

went with center for levels, left for the text. thanks!

@CodyCBakerPhD
Copy link
Contributor

'Explained level options with examples' for PR title (CHANGELOG)

One minor style suggestion

These docs are getting quite sophisticated

@asmacdo asmacdo changed the title explain level options with examples Explained level options with examples Feb 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

semver-documentation Changes only affect the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Enhance documentation with log level examples

2 participants