til.md

you can mark comments on postgres tables and columns like what-what:

comment on table user is 'this table stores user info';
comment on column user.age is 'user age';

and view them in psql

\d+ user

\d+ is like a verbose description of your table