Skip to content

docs: strip references - #34

Merged
0xvasanth merged 1 commit into
mainfrom
docs/strip-langchain-refs
May 8, 2026
Merged

docs: strip references#34
0xvasanth merged 1 commit into
mainfrom
docs/strip-langchain-refs

Conversation

@0xvasanth

@0xvasanth 0xvasanth commented May 8, 2026

Copy link
Copy Markdown
Owner

Summary

Removes every mention of the four LangChain-team products (LangChain, LangGraph, DeepAgents, LangSmith) from active code, docs, and the contributor templates. Langfuse references are kept — it's an integrated tracing backend (the LangfuseExporter ships in cognis-trace), not a sibling product.

Highlights

  • README, CLAUDE.md, introduction.mdx: dropped the "inspired by" notes and rewrote the framing in neutral language that describes what Cognis is on its own terms.
  • get-started/comparison.mdx: deleted. The page existed only to compare Cognis to those projects; without them it has no reason to be there. docs.json and inbound links updated.
  • observability + trace reference: dropped the "LangSmith" roadmap mentions; OpenTelemetry remains the named Phase-2 target.
  • graphs / streaming / patterns: replaced "LangGraph-style" / "inspired by LangGraph" with "Pregel-style".
  • Renamed the misleading example: examples/graphs/langgraph_agent.rsagent_builder_graph.rs (registered name graphs_langgraph_agentgraphs_agent_builder). The example never used LangGraph code; the name was a misleading hint.
  • Module doc-comments scrubbed in cognis-core/src/callbacks.rs, cognis/src/history.rs, cognis/src/observers/{mod,tracing_observer}.rs, cognisgraph/src/stream_mode.rs, cognis-rag/src/splitters/recursive.rs, cognis-trace/{Cargo.toml,src/lib.rs}.
  • README tracing row + cognis-trace feature table: dropped the langsmith feature flag from the listing — it was never implemented; only stdout and langfuse exist in cognis-trace/Cargo.toml.
  • .github/PULL_REQUEST_TEMPLATE.md: was listing the legacy V1 crate names (rustchain-core, rustchain, langgraph, deepagents). Refreshed to the current v0.3 layout.
  • .github/CONTRIBUTING.md: rewritten for the current workspace; trimmed since full contributor docs live in docs/mintlify/contribute/.

Test plan

  • grep -rEni 'langchain|langgraph|deepagents|langsmith' across active code and docs returns zero matches.
  • cargo check -p cognis-core -p cognis-llm -p cognis-rag -p cognis-graph -p cognis-trace -p cognis passes.
  • cargo check -p cognis-examples --example graphs_agent_builder passes (renamed example builds).
  • Mintlify preview renders cleanly (Mintlify Deployment check will run).

Notes

  • crates/v1/ was excluded from the scrub on purpose — that directory is the frozen V1 source and isn't user-facing.
  • Langfuse references stay (integrated backend, real shipping code).
  • Provider names (Ollama, OpenAI, Anthropic, Google, Azure, OpenRouter, Voyage) stay (real integrations).

Summary by cubic

Removes all mentions of LangChain, LangGraph, DeepAgents, and LangSmith from code, docs, and contributor templates to make the project self-contained. Langfuse stays supported; OpenTelemetry remains on the roadmap.

  • Refactors
    • Deleted docs/mintlify/get-started/comparison.mdx; updated docs.json and links.
    • Rewrote docs to neutral “Pregel-style” phrasing; scrubbed module doc-comments.
    • Renamed examples/graphs/langgraph_agent.rsagent_builder_graph.rs; updated crates/examples/Cargo.toml and docs.
    • Dropped langsmith from cognis-trace description and feature list; clarified OTel as Phase 2.
    • Updated .github/PULL_REQUEST_TEMPLATE.md and .github/CONTRIBUTING.md to current crate layout (cognis-core, cognis-llm, cognis-rag, cognis-graph, cognis-trace, cognis-macros, cognis).
    • Verified grep returns zero matches and cargo check (incl. renamed example) passes.

Written for commit 0474cbe. Summary will update on new commits.

Removes every mention of the four LangChain-team products from active
code, docs, and the contributor templates. Langfuse references are
kept (it's an integrated tracing backend, shipped via the
LangfuseExporter, not a sibling product).

- README, CLAUDE.md, introduction.mdx: dropped the "inspired by" notes
  and replaced "LangChain / LangGraph / DeepAgents" framing with neutral
  language that describes what Cognis is on its own terms.

- get-started/comparison.mdx: deleted. The page existed only to compare
  Cognis to those projects; without them it has no reason to be there.
  docs.json + the inbound links from changelog.mdx were updated.

- observability/langfuse.mdx, reference/api/cognis-trace.mdx: dropped
  the "LangSmith" roadmap mentions; OpenTelemetry remains as the named
  Phase-2 target. Other backends are described as "implement
  TraceExporter" without naming products.

- core-ideas/graphs.mdx, building-agents/streaming.mdx,
  patterns/local-ollama.mdx, examples/retrieval/*.rs: replaced
  "LangGraph-style" / "inspired by LangGraph" with "Pregel-style".

- examples/graphs/langgraph_agent.rs -> agent_builder_graph.rs.
  Registered name graphs_langgraph_agent -> graphs_agent_builder. The
  example never used LangGraph code; the name was a misleading hint.

- crates/cognis-core/src/callbacks.rs, crates/cognis/src/history.rs,
  crates/cognis/src/observers/{mod,tracing_observer}.rs,
  crates/cognisgraph/src/stream_mode.rs,
  crates/cognis-rag/src/splitters/recursive.rs,
  crates/cognis-trace/{Cargo.toml,src/lib.rs}: scrubbed module-doc
  references. Wording is now self-contained.

- README "Tracing" row + cognis-trace feature table: dropped the
  "langsmith" feature flag from the listing (it was never implemented;
  only "stdout" and "langfuse" exist in cognis-trace/Cargo.toml).

- .github/PULL_REQUEST_TEMPLATE.md: was listing the legacy V1 crate
  names (rustchain-core, rustchain, langgraph, deepagents). Refreshed
  to the current v0.3 layout (cognis-core/-llm/-rag/-graph/-trace/-macros
  + the umbrella).

- .github/CONTRIBUTING.md: same rewrite, scoped to the current
  workspace. Trimmed; full contributor docs live in docs/mintlify/contribute/.

Verified `cargo check -p cognis-core -p cognis-llm -p cognis-rag
-p cognis-graph -p cognis-trace -p cognis` and the renamed example
build cleanly. `grep -rEni 'langchain|langgraph|deepagents|langsmith'`
across active code and docs returns zero matches.
@mintlify

mintlify Bot commented May 8, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cognis 🟢 Ready View Preview May 8, 2026, 3:22 PM

@0xvasanth 0xvasanth changed the title docs: strip references to LangChain / LangGraph / DeepAgents / LangSmith docs: strip references May 8, 2026
@0xvasanth
0xvasanth merged commit e9175f4 into main May 8, 2026
7 checks passed
@0xvasanth
0xvasanth deleted the docs/strip-langchain-refs branch May 8, 2026 15:22
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