Skip to content

Org profile README has stale repo links, a member-only Discord URL, and duplicated sections #28

Description

@rahlk

What's wrong
The org profile README has accumulated link rot, duplication, and structure that grew section by section.

Broken or stale:

  • codeanalyzer-ts and cocoa-py resolve only via GitHub rename redirects (now codeanalyzer-typescript and cocoa-mcp). Nothing 404s today, which is why this went unnoticed — the links break only if a name is ever reclaimed.
  • The Discord link is a discord.com/channels/<guild>/<channel> deep-link. It resolves for people already in the server and fails for everyone else, exactly inverting its purpose.
  • The Contact table displays rangeet.pan@ibm.com but the mailto: points at gmail.
  • The <picture> element's fallback <img> has no src attribute, so it has no working fallback.
  • badge.fury.io/py/cldk and opensource.org/licenses/Apache-2.0 both 30x-redirect.

Live but not worth linking:

  • npm @codellm-devkit/cldk is 0.0.0-pre-alpha, published April 2025 and never updated.
  • codeanalyzer-go (124 KB) and codeanalyzer-rust (93 KB, last pushed Feb 2025) are stubs.

Duplication:

  • "Documentation and Examples" repeats bullets already under Getting Started.
  • The second code example differs from the first by two words.

Where
profile/README.md in codellm-devkit/.github, rendered at https://github.com/codellm-devkit.

Expected
Every link resolves without relying on a redirect, no section duplicates another, and the page is restructured on the shape of the Model Context Protocol org profile README.

COCOA references come out entirely for now — the org has three COCOA repos (cocoa, cocoa-mcp, cocoa-ts) where the README describes one, and the landing page is the wrong place to settle that.

Additional context
Definition of done

  • Every URL returns 200 without a redirect, except discord.gg, whose 301 is Discord's own canonical shortener.
  • No link targets a stub repo or a pre-alpha package.
  • Every mailto: matches the address displayed beside it.
  • No occurrence of "cocoa" in any form.
  • The logo renders in both themes and its <img> fallback has a src and a descriptive alt.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions