Skip to content

docs: replace stale Mintlify starter content#1010

Merged
rrajan94 merged 1 commit intoTracer-Cloud:mainfrom
Ryjen1:fix/825-docs-readme-cleanup
Apr 27, 2026
Merged

docs: replace stale Mintlify starter content#1010
rrajan94 merged 1 commit intoTracer-Cloud:mainfrom
Ryjen1:fix/825-docs-readme-cleanup

Conversation

@Ryjen1
Copy link
Copy Markdown
Contributor

@Ryjen1 Ryjen1 commented Apr 27, 2026

This PR addresses issue #825 by replacing the stale Mintlify starter kit boilerplate in docs/README.md with relevant, OpenSRE-specific documentation instructions. It also introduces a convenience target in the Makefile to streamline the local documentation preview process.

Changes

  • docs/README.md:
    • Removed "Mintlify Starter Kit" boilerplate.
    • Added clear prerequisites (Node.js/npm) and setup steps for the Mintlify CLI.
    • Documented the repository structure for documentation (docs.json, *.mdx, images/, snippets/).
    • Added contribution guidelines for documentation.
  • Makefile:
    • Added docs-dev target to start the local documentation preview directly from the project root (cd docs && mint dev).
    • Updated the Makefile help menu to include docs-dev under the "LOCAL DEVELOPMENT" section.

Fixes

Fixes #825

Verification

  • Verified docs/README.md content accuracy.
  • Verified Makefile target implementation and help text.
  • Ran make lint and make format-check to ensure repository quality standards are met

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 27, 2026

Greptile Summary

This PR replaces the stale Mintlify starter kit boilerplate in docs/README.md with OpenSRE-specific documentation instructions and adds a docs-dev Make target for previewing docs locally. The changes are accurate, well-structured, and the new Make target correctly uses cd docs && mint dev in a single subshell.

Confidence Score: 5/5

Safe to merge — documentation-only changes with a trivial Makefile addition, no logic affected.

All changes are documentation and a simple shell-passthrough Make target. No logic, data, or security surface is touched. No findings of P1 or higher severity.

No files require special attention.

Important Files Changed

Filename Overview
docs/README.md Replaced Mintlify starter boilerplate with clear, OpenSRE-specific setup instructions, structure overview, and contribution guidelines. No issues found.
Makefile Added docs-dev target (cd docs && mint dev) and corresponding help text; consistent with other local-dev targets in the file.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Developer] -->|"make docs-dev"| B["Makefile: docs-dev target"]
    B -->|"cd docs && mint dev"| C["Mintlify CLI (mint)"]
    C --> D["Local preview at http://localhost:3000"]

    A2[Developer] -->|"cd docs && mint dev"| C

    subgraph docs/
        E["docs.json (config)"]
        F["*.mdx (pages)"]
        G["images/ (assets)"]
        H["snippets/ (reusable blocks)"]
    end

    C --> docs/
Loading

Reviews (1): Last reviewed commit: "docs: replace stale Mintlify starter con..." | Re-trigger Greptile

@rrajan94
Copy link
Copy Markdown
Collaborator

LGTM 👍

@rrajan94 rrajan94 merged commit 6e8f880 into Tracer-Cloud:main Apr 27, 2026
7 checks passed
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.

Replace stale Mintlify starter content in docs/README.md

2 participants