docs(components): add Pagination component documentation (#399

[mysterio123865]

Summary

Implements Issue #399 by adding comprehensive documentation for the shared Pagination component and linking it across project documentation.

Changes

• Added docs/pagination.md

  • Documented component props and usage
  • Explained render-state precedence:
    • Error
    • Loading
    • Hidden
    • Navigation
  • Added accessibility (a11y) guidance
  • Included usage examples aligned with the current Pagination.tsx implementation

• Updated documentation references:

  • Linked Pagination docs from docs/components.md
  • Added Pagination documentation reference in the README shared-components section

Validation

✅ Pagination tests passed (20/20)
✅ npm run build completed successfully

Note: npm run lint still fails due to an existing upstream issue in services/[serviceId]/edit/page.tsx. This was left unchanged as requested and is unrelated to this documentation update.

Tracking

Closes #399

[mikewheeleer]

@mysterio123865 this closes #399 nicely. LGTM, merging 🎉