Skip to content

UX & marketing: v2 launch readiness #118

Description

@sc2ben

UX / marketing findings from the pre-v2 review (open-source landing + generated site theme), gating the public launch. [confirmed] = verified; [unverified] = plausible, confirm before acting.

Open items

  • [confirmed] LAUNCH BLOCKER — docs site 404s. https://sc2in.github.io/policypress/ and the README's only documentation link (/guides/installation/) both 404. The whole funnel has no working path. Deploy the docs site or repoint the links.
  • [confirmed] high — license is incoherent. README pitches commercial SMBs, LICENSE is PolyForm Noncommercial, and theme.toml declares AGPL-3.0; no surface explains a commercial path. Decide the story; at minimum fix theme.toml and add a licensing/commercial paragraph.
  • [confirmed] medium — README shows nothing. No screenshot, GIF, sample PDF, or live-demo link — a visitor can't see the product without installing. No differentiation vs Notion/Confluence/SharePoint or Drata/Vanta or plain Zola/MkDocs. Positioning voice flips between "consultant with customers" and "SMB owner." CHANGELOG header still says "0.x until stable" while the log is at 1.4.x.
  • [confirmed] medium — "dashboard" homepage has no dashboard. templates/index.html shows no policy status, review dates, or coverage — conflicts with the intended dashboard-first homepage.
  • [confirmed] medium — icons load from a third-party CDN. templates/macros/head.html pulls Font Awesome from cdnjs, breaking offline/intranet use and leaking visitor data from a compliance site. Self-host a subset.
  • [unverified] high — starter homepage renders nearly empty. The starter config.toml frontpage keys appear ignored by the current layout; first-run impression is broken.
  • [unverified] medium — customer branding is hard. pdf_color doesn't drive the web theme (web color hardcoded in sass/common/_variables.scss); the logo is configured in two undocumented places; the search dropdown is unreadable in dark mode (hardcoded bg-white).

Part of the Public Launch gate. Full evidence (file:line) is in the internal review notes.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingenhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions