Skip to content

Moved documentation from docs/content to README.md.#142

Merged
AlexSkrypnyk merged 1 commit into
mainfrom
feature/move-docs-readme
Feb 6, 2026
Merged

Moved documentation from docs/content to README.md.#142
AlexSkrypnyk merged 1 commit into
mainfrom
feature/move-docs-readme

Conversation

@AlexSkrypnyk
Copy link
Copy Markdown
Member

@AlexSkrypnyk AlexSkrypnyk commented Feb 6, 2026

Summary by CodeRabbit

  • Documentation

    • Consolidated project documentation into the main README with expanded Usage section covering Assertions, Data Provider, Mocking, Step Runner, and Helpers.
  • Chores

    • Removed documentation site infrastructure and associated automated workflows.
    • Updated project configuration for cleaner distribution exports.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Feb 6, 2026

📝 Walkthrough

Walkthrough

The PR removes the Docusaurus-based documentation infrastructure entirely, including configuration files, build workflows, and all markdown content. Documentation is consolidated into the main README.md. Git export rules and development notes are updated to reflect the changes.

Changes

Cohort / File(s) Summary
Documentation Site Infrastructure
docs/docusaurus.config.js, docs/babel.config.js, docs/sidebars.js, docs/cspell.json, docs/terminalizer.yml
Removed Docusaurus configuration, Babel preset, sidebar definitions, spell-check configuration, and terminal recording setup.
Documentation Build & Dependencies
docs/package.json, docs/README.md, docs/.gitignore, docs/static/README.md, docs/src/css/custom.css
Deleted package manifest, documentation guides, gitignore rules, static assets documentation, and custom theme styles for Docusaurus.
Documentation Content
docs/content/README.mdx, docs/content/assertions.mdx, docs/content/data-provider.mdx, docs/content/helpers.mdx, docs/content/mocking.mdx, docs/content/step-runner.mdx
Removed all Markdown documentation pages covering features, assertions, data providers, helpers, mocking utilities, and step runners.
GitHub Actions Workflows
.github/workflows/release-docs.yml, .github/workflows/test-docs.yml
Deleted documentation build and deployment workflows for GitHub Pages and Netlify publishing.
Root Configuration Updates
.gitattributes, CLAUDE.md, README.md
Updated export-ignore entries, removed Documentation section from CLAUDE.md, and expanded README.md with comprehensive Usage section covering all previously documented features.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: moving documentation from a separate docs/content directory to the README.md file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/move-docs-readme

Comment @coderabbitai help to get the list of available commands and usage tips.

@AlexSkrypnyk AlexSkrypnyk merged commit 2a7b716 into main Feb 6, 2026
6 of 7 checks passed
@AlexSkrypnyk AlexSkrypnyk deleted the feature/move-docs-readme branch February 6, 2026 00:30
@codecov
Copy link
Copy Markdown

codecov Bot commented Feb 6, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.97%. Comparing base (7fc3ed8) to head (8d39f23).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #142   +/-   ##
=======================================
  Coverage   94.97%   94.97%           
=======================================
  Files          12       12           
  Lines         517      517           
=======================================
  Hits          491      491           
  Misses         26       26           

☔ 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.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README.md (1)

24-356: ⚠️ Potential issue | 🟠 Major

Update external documentation reference on line 2.

This PR consolidates documentation from docs/content/ into README.md. While this contradicts the established learning that project documentation should live under docs/ and be maintained via Docusaurus, the evidence shows Docusaurus was not actively in use (no config files or dependencies found).

However, line 2 contains a link to https://bats-helpers.drevops.com — an external documentation site reference that conflicts with the new README-centric approach. Update this reference to point to the GitHub repository or remove it to avoid directing users to outdated or broken documentation.

🤖 Fix all issues with AI agents
In `@README.md`:
- Line 182: The sentence "This is a very powerful feature that allows to test
complex scenarios as unit" in README.md should be reworded for stronger, clearer
phrasing; replace it with a more precise alternative such as "This powerful
feature enables testing complex scenarios in unit tests" (or another concise
variant) and ensure grammar ("allows to test" -> "enables testing" and add
"tests" after "unit") so the sentence reads smoothly and unambiguously.
- Around line 55-56: Replace the wordy instruction "Click `Code` -> `Download
ZIP` in the [GitHub UI]" with a more concise phrase such as "Download ZIP from
the repository's Code menu" (edit the README.md line that contains that exact
phrase) so the step reads shorter and clearer while preserving the link to the
GitHub UI.

Comment thread README.md
Comment on lines +55 to +56
1. Click `Code` -> `Download ZIP` in
the [GitHub UI](https://github.com/drevops/bats-helpers).
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🧹 Nitpick | 🔵 Trivial

Consider more concise wording for download instructions.

The phrase "Click Code -> Download ZIP in the [GitHub UI]" works but could be streamlined.

📝 Suggested refinement
-1. Click `Code` -> `Download ZIP` in
-   the [GitHub UI](https://github.com/drevops/bats-helpers).
+1. Download the [latest release](https://github.com/drevops/bats-helpers/archive/refs/heads/main.zip)
+   or click `Code` → `Download ZIP` on the [repository page](https://github.com/drevops/bats-helpers).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
1. Click `Code` -> `Download ZIP` in
the [GitHub UI](https://github.com/drevops/bats-helpers).
1. Download the [latest release](https://github.com/drevops/bats-helpers/archive/refs/heads/main.zip)
or click `Code``Download ZIP` on the [repository page](https://github.com/drevops/bats-helpers).
🤖 Prompt for AI Agents
In `@README.md` around lines 55 - 56, Replace the wordy instruction "Click `Code`
-> `Download ZIP` in the [GitHub UI]" with a more concise phrase such as
"Download ZIP from the repository's Code menu" (edit the README.md line that
contains that exact phrase) so the step reads shorter and clearer while
preserving the link to the GitHub UI.

Comment thread README.md

It allows to mock commands and check how they were called.

This is a very powerful feature that allows to test complex scenarios as unit
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🧹 Nitpick | 🔵 Trivial

Optional: Consider alternative phrasing.

Static analysis suggests "very powerful feature" could use a stronger descriptor. This is a minor style point—the current wording is perfectly clear.

✍️ Alternative phrasing
-This is a very powerful feature that allows to test complex scenarios as unit
+This enables comprehensive testing of complex scenarios as unit
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
This is a very powerful feature that allows to test complex scenarios as unit
This enables comprehensive testing of complex scenarios as unit
🧰 Tools
🪛 LanguageTool

[style] ~182-~182: As an alternative to the over-used intensifier ‘very’, consider replacing this phrase.
Context: ...nd check how they were called. This is a very powerful feature that allows to test complex sce...

(EN_WEAK_ADJECTIVE)

🤖 Prompt for AI Agents
In `@README.md` at line 182, The sentence "This is a very powerful feature that
allows to test complex scenarios as unit" in README.md should be reworded for
stronger, clearer phrasing; replace it with a more precise alternative such as
"This powerful feature enables testing complex scenarios in unit tests" (or
another concise variant) and ensure grammar ("allows to test" -> "enables
testing" and add "tests" after "unit") so the sentence reads smoothly and
unambiguously.

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