Skip to content

Send OpenTag readers to OpenBot from the top of the README - #104

Draft
jerelvelarde wants to merge 1 commit into
mainfrom
jerel/2026-11-19/readme-openbot-block
Draft

jerelvelarde wants to merge 1 commit into
mainfrom
jerel/2026-11-19/readme-openbot-block

Conversation

@jerelvelarde

Copy link
Copy Markdown
Collaborator
Before (main) After (this branch)
Top of the README on main Top of the README on this branch

The problem

OpenTag's README doesn't mention OpenBot, though OpenBot's own docs name OpenTag as the way OpenBot reaches Slack and Teams. A reader who finds OpenTag gets no pointer to OpenBot from this side, and open.bot gets no link from it.

The approach

A short block goes directly under the tagline: "From the team behind OpenBot", with OpenBot linked to open.bot, one sentence on how the two connect, and the same two buttons the other Open projects now carry (open.bot, and the OpenBot repository showing its live star count).

The sentence is careful because the pairing is half built. OpenBot implements its side and documents it in docs/configuration.md, under "Slack and Microsoft Teams (OpenTag pairing)", in v1.1.0 and v1.1.1. OpenTag's side isn't on main. #92, still a draft, is the first piece: without it, OpenBot refuses OpenTag's turns because they don't say who sent them. So the README says OpenBot is designed to reach Slack and Teams through OpenTag, links OpenBot's pairing docs on GitHub, and says OpenTag's side is still in progress. It doesn't tell anyone to point AGENT_URL at OpenBot today.

Nothing else in the README changes.

What is not covered

Verification

  • The screenshots above are GitHub's own render of README.md at 1280 px wide: before is main at 07f25a7, after is this branch.
  • prettier --check README.md flags the same existing table (the tools environment variables) on main and on this branch. The new lines add nothing to it, and CI doesn't run Prettier.
  • The pairing link's anchor matches the heading in OpenBot's docs/configuration.md on main.

This branch has not been deployed

No deployments
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