Skip to content

docs: add GoDoc for public API and package docs#9

Merged
kpiljoong merged 1 commit into
mainfrom
docs/package-comment-issue-4-fix-author
Mar 14, 2026
Merged

docs: add GoDoc for public API and package docs#9
kpiljoong merged 1 commit into
mainfrom
docs/package-comment-issue-4-fix-author

Conversation

@kpiljoong
Copy link
Copy Markdown
Collaborator

Summary

Add GoDoc comments for the public orderlyid API and improve the package-level documentation.

This updates the docs to describe:

  • the canonical string form (prefix_payload[-checksum])
  • the prefix validation rule
  • the 160-bit payload structure and Crockford Base32 encoding
  • the meaning of each binary field (time, flags, tenant, sequence, shard, random)
  • checksum behavior and current parsing behavior

The package docs are now closer to the spec while remaining truthful to the current implementation, especially around case handling and behaviors not yet enforced in code.

Closes #4

@kpiljoong kpiljoong merged commit 689ac42 into main Mar 14, 2026
1 check passed
@kpiljoong kpiljoong deleted the docs/package-comment-issue-4-fix-author branch March 14, 2026 01:14
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.

Add GoDoc comments for all exported identifiers

1 participant