Skip to content

docs: rewrite README to reflect the actual API#66

Merged
D4M13N-D3V merged 1 commit into
mainfrom
docs/readme
Jun 1, 2026
Merged

docs: rewrite README to reflect the actual API#66
D4M13N-D3V merged 1 commit into
mainfrom
docs/readme

Conversation

@D4M13N-D3V

Copy link
Copy Markdown
Owner

What

Replaces the generic template README with accurate documentation of the real service.

Why

The old README described a different/aspirational project — it referenced art_platform, a wrong clone URL (D4M13N-D3V/art_platform), a non-existent Dockerfile path (./src/ArtPlatform.API/Dockerfile), port 80, and had empty "describe your API here" placeholders. None of it matched the codebase.

New README covers

  • Tech stack — .NET 8, EF Core 8 + PostgreSQL, Auth0, Stripe Connect, Novu, Swagger
  • Repo layout — the 4 projects and what each does
  • API surface — discovery / user / artist / requests / payments / admin
  • Auth — Auth0 JWT + the 6 scopes + admin role + auto user provisioning
  • Configuration — full table of every config key, which are required, env-var convention
  • Local setup — Docker Postgres + config + dotnet run (port 5290, swagger path)
  • Migrations — startup flag vs the migrator project
  • Docker — correct build path + GHCR image name
  • CI/CD — the workflows from CI/CD overhaul: scans, Dependabot, GitVersion release + image publishing #46 + Dependabot + GitVersion

All facts verified against the running app and source this session.

Independent of #46 (CI/CD); the CI table reflects the workflows that PR adds.

The previous README was a generic template ("art_platform", wrong clone
URL, wrong Dockerfile path, no real configuration or auth docs). Rewrite
it to describe the real service: .NET 8 / EF Core / PostgreSQL, Auth0
scope-based auth, Stripe Connect, Novu, the repo layout, the API surface,
full configuration reference, local setup with Docker Postgres, migrations,
Docker, and the CI/CD pipeline.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@D4M13N-D3V D4M13N-D3V merged commit 3f7457f into main Jun 1, 2026
5 checks passed
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