Skip to content

docs: add Nushell code style guide#109

Closed
maxim-uvarov wants to merge 4 commits intomainfrom
style-guide-docs
Closed

docs: add Nushell code style guide#109
maxim-uvarov wants to merge 4 commits intomainfrom
style-guide-docs

Conversation

@maxim-uvarov
Copy link
Copy Markdown
Member

Summary

Add STYLE.md documenting Nushell coding preferences extracted from repository history.

Covers:

  • Pipeline composition (leading |, pass-through { }, scan, window)
  • Data-first filtering patterns
  • Command choices (where, match, items, safe navigation ?)
  • Code structure (type signatures, @example, const for static data)
  • Formatting conventions (Topiary-compatible)
  • Quick reference do/don't list

Useful for AI-assisted development to maintain consistent style.

Test plan

  • Documentation only, no code changes

🤖 Generated with Claude Code

claude and others added 4 commits January 1, 2026 00:24
Extract coding style patterns from git history (Sep 2024 onwards)
to document Maxim's Nushell preferences for AI-assisted development.

Covers pipeline composition, command choices, code structure,
formatting conventions, and contrasts with Claude's style.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Remove Maxim vs Claude contrast framing, state preferences directly.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Extracted from version commit iterations:
- Prefer data-first approach: define all data, then filter with `where`
- Use `where` instead of `each {if} | compact`
- Avoid spread operator with conditionals
- Avoid unnecessary parentheses on external commands

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@maxim-uvarov maxim-uvarov deleted the style-guide-docs branch March 21, 2026 23:06
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.

2 participants