You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by "morningman (via GitHub)" <gi...@apache.org> on 2026/10/07 04:02:43 UTC

[PR] [course] Add Glasgow 2026 hackathon task pages; fix the RRF quick start and update the MCP Server page for 1.0 [doris-website]

morningman opened a new pull request, #4188:
URL: https://github.com/apache/doris-website/pull/4188

   ## Versions 
   
   - [x] dev
   - [x] 4.x
   - [ ] 3.x
   - [ ] 2.1 or older (not covered by version/language sync gate)
   
   ## Languages
   
   - [ ] Chinese
   - [x] English
   
   ## Docs Checklist
   
   - [x] Checked by AI
   - [x] Test Cases Built
   - [x] Updated required version and language counterparts, or explained why not
   - [x] If only one language changed, confirmed whether source/translation counterparts need sync
   
   The key-features pages touched here (Reciprocal Rank Fusion, Hybrid Search, MCP Server) exist only in English, under `docs/` and `versioned_docs/version-4.x/`; both copies are updated and stay identical. The hackathon pages are English-only event pages under `src/`.
   
   ## What this PR changes
   
   ### 1. Hackathon task pages (`/course/hackathon/glasgow-2026/…`)
   
   Commits `[course] add Glasgow 2026 hackathon Track A task pages`, `[course] point hackathon tasks at all-in-one 4.1.3 and verified data` and `[course] drop Windows instructions from the hackathon task pages`.
   
   Four Track A task pages for the Apache Doris hackathon at Community over Code 2026 Glasgow (Tuesday 13 October): A1 Hybrid Search App, A2 Ask Doris with MCP, A3 Log Search Explorer and A4 Agent Trace Explorer, plus a "Doris 101 | Hackathon" switch in the `/course` path card.
   
   - One template for all four: steps on the left, a sticky code panel with a wireframe sketch on the right; below 1080px every step shows its code inline.
   - Participants run `apache/doris:all-in-one-4.1.3` (`docker pull` / `run` / `exec`, using the MySQL client inside the container) and a starter kit downloaded from `morningman/demo-env` (seed data, an offline toy embedder, `doris.sh`, starter code, `AGENTS.md`). macOS and Linux only.
   - Every milestone ends with a checkpoint taken from real output, and the trap and troubleshooting tables quote the errors participants actually hit (`score()` placement rules, vector driver parameters, `Current database is not set`, …).
   - Submission: a pull request to `morningman/demo-env` with one folder per GitHub ID, open until 31 October; questions in `#dev` on the Apache Doris Slack; the Contributor badge for everyone who takes part on site.
   - Event data lives in `hackathonEvent.ts`; `HACKATHON_COURSE_TRACK_ENABLED` turns the `/course` switch off after the event.
   - The Slack nudge no longer opens on its own on `/course/hackathon/*` (it covered the code panel), and long code-block labels truncate so the Copy button stays visible on phones.
   
   ### 2. Reciprocal Rank Fusion quick start (commit `[docs] fix the RRF quick start …`)
   
   - The quick-start SQL used `ROW_NUMBER() OVER (ORDER BY score() DESC)` in the query that computes `score()`. Doris rejects that (`score() function requires WHERE clause with MATCH function, ORDER BY and LIMIT for optimization`). The query now selects the plain `score()` and ranks it one level up.
   - The quick start now creates and fills its own table. Before, it read a `docs` table it never filled, and its expected result could not happen: it listed an id 7 that the sample data does not have, and two rows ranked first in the same list.
   - Hybrid Search no longer tells readers to fuse rankings in the application; it points to the RRF pattern instead.
   
   ### 3. MCP Server page for doris-mcp-server 1.0 (same commit)
   
   The page described the pre-1.0 server: `uv --project … run doris-mcp`, `DB_*` variables and eight flat tools such as `exec_query`. It now covers 1.0:
   
   - installation with `pip install doris-mcp-server==1.0.0` and the `DORIS_*` variables;
   - eight domains with 55 child capabilities, discovered on demand, and `MCP_TOOL_EXPOSURE_MODE=flat` for clients that cannot make the two-step call;
   - stdio and Streamable HTTP transports, with the `/mcp`, `/live` and `/ready` endpoints;
   - the read-only runtime and the default result limits;
   - a quick start that creates a read-only user.
   
   ## Validation
   
   - **Hackathon pages and starter kit:** every SQL statement on the four task pages and in the starter kit was run on `apache/doris:all-in-one-4.1.3`, and the checkpoint numbers come from that output. The kit was also run end to end from its ZIP in a fresh container: start, all seeds, the drift batch, the read-only user and the RRF example.
   - **RRF quick start:** the SQL was taken from the page as is and run on 4.1.3 and on a master build. Both return the documented result.
   - **MCP quick start:** the SQL block ran as is. The server (`doris-mcp-server` 1.0.0) was then driven over stdio with the documented config. The tool list, the `execute_query` rows and limits, and the refused `DELETE` all match the page.
   - **Static checks:**
     - The six edited `.mdx` files compile with Docusaurus's MDX processor, and their heading anchors are unchanged.
     - `node --test` passes for `hackathon.logic` and `SlackCommunityNudge.logic` (17 tests).
     - The changed hackathon files are Prettier-clean.
     - The task pages render in Chrome at 1440px and 390px on the dev server.
   
   Not in this PR: the Hybrid Search quick start creates its `docs` table without inserting rows, although its expected result shows two of them.
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org


Re: [PR] [course] Add Glasgow 2026 hackathon pages for Tracks A and B; fix key-features quick starts and update the MCP Server page for 1.0 [doris-website]

Posted by "morningman (via GitHub)" <gi...@apache.org>.
morningman merged PR #4188:
URL: https://github.com/apache/doris-website/pull/4188


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org