📝 Clarify routes.router

README.md

@@ -126,9 +126,10 @@ from ohmyapi.db.exceptions import DoesNotExist
 
 from .models import Tournament
 
-# If <app>.routes.router exists and is an APIRouter, OhMyAPI will
+# Expose your app's routes via `router = fastapi.APIRouter`.
-# automatically pick it up and add it to the app's main APIRouter.
+# Use prefixes wisely to avoid cross-app namespace-collisions.
-router = APIRouter(prefix="/tournament")
+# Tags improve the UX of the OpenAPI docs at /docs.
+router = APIRouter(prefix="/tournament", tags=['Tournament'])
 
 
 @router.get("/")

src/ohmyapi/core/templates/app/routes.py.j2

@@ -1,11 +1,15 @@
 from ohmyapi.router import APIRouter
+
 from . import models
 
-router = APIRouter(prefix="/{{ app_name }}")
+# Expose your app's routes via `router = fastapi.APIRouter`.
+# Use prefixes wisely to avoid cross-app namespace-collisions.
+# Tags improve the UX of the OpenAPI docs at /docs.
+router = APIRouter(prefix="/{{ app_name }}", tags=[{{ app_name }}])
 
 
 @router.get("/")
-def ping():
+def hello_world():
     return {
         "project": "{{ project_name }}",
         "app": "{{ app_name }}",