Skip to content

Docs touchups#10

Merged
K1-R1 merged 7 commits intomainfrom
docs/promotional-materials
Mar 26, 2026
Merged

Docs touchups#10
K1-R1 merged 7 commits intomainfrom
docs/promotional-materials

Conversation

@K1-R1
Copy link
Copy Markdown
Owner

@K1-R1 K1-R1 commented Mar 17, 2026

This pull request delivers significant improvements to documentation, shell completions, and configuration for the smoosh project. The README has been rewritten for clarity and conciseness, with improved installation, usage, and feature documentation. Additionally, new shell autocompletion scripts for Bash, Zsh, and Fish have been added, making the CLI more user-friendly. Minor configuration adjustments were made to .editorconfig and .gitattributes for consistency and better handling of files.

Documentation improvements:

  • Major rewrite and simplification of README.md: clearer quick start, installation, usage, and feature sections; improved AI tool integration guides; more concise FAQ; and better formatting throughout. [1] [2] [3] [4] [5] [6]
  • Minor cleanup in CONTRIBUTING.md for clarity.

Shell completions:

  • Added Bash (completions/smoosh.bash), Zsh (completions/smoosh.zsh), and Fish (completions/smoosh.fish) autocompletion scripts to enhance CLI usability. [1] [2] [3]

Configuration and housekeeping:

  • Updated .editorconfig for consistent whitespace, charset, and trimming rules.
  • Improved .gitattributes to better handle line endings, linguist settings, and to hide golden test outputs from PR diffs and language stats.

K1-R1 added 7 commits March 26, 2026 06:32
- FAQ: 228 tests → 231 (3 new tests added in v1.0.2)
- Install env vars table: example version 1.0.1 → 1.0.2

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
- Cut generic "AI tools are powerful" opener in Why smoosh — start with
  the specific pain point
- Remove abstract "Technical knowledge becomes accessible" sentence and
  its negative parallelism ("not just X")
- Replace "No hallucinations, all sources cited" overclaim with factual
  "all with source citations"
- Remove chatbot opener from CONTRIBUTING.md

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
- Remove docs/plans/ plan file that was committed despite docs/ gitignore
  (git rm --cached — gitignore only prevents untracked files)
- Remove .agent/ directory (redundant with CLAUDE.md and CONTRIBUTING.md)
- Add .agent/ to .gitignore

Local copies preserved. No content changes.

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
Agent rules and workflows are useful for contributors using AI tools
other than Claude Code (Codex, Gemini CLI, etc.).

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
…e, including a new "How it Works" section and streamlined installation/usage instructions.

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
…refine editor and git attributes configurations.

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
…d and test artifacts.

Signed-off-by: K1-R1 <77465250+K1-R1@users.noreply.github.com>
@K1-R1 K1-R1 force-pushed the docs/promotional-materials branch from 1b118c9 to f30c0fe Compare March 26, 2026 06:32
@K1-R1 K1-R1 changed the title docs: fix stale test count and version in README Docs touchups Mar 26, 2026
@K1-R1 K1-R1 merged commit c5c74d6 into main Mar 26, 2026
6 checks passed
@K1-R1 K1-R1 deleted the docs/promotional-materials branch March 26, 2026 06:34
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.

1 participant