Confusion in tables docs

[dickermoshe]

Discussed in https://github.com/simolus3/drift/discussions/3565

^{Originally posted by MaxLap May 19, 2025} In the https://drift.simonbinder.eu/dart_api/tables docs pages, I cannot find the distinction between the following ways of declaring columns, which both appear in that page:

TextColumn get title => text()();
late final name = text()()

There is even late final Column<int> age = integer().check(age.isBiggerOrEqualValue(0))(); at one place.

Is this a old way vs new way that wasn't updated everywhere? Is there an actual distinction? I would suggest making that clearer in the docs. Thanks!

[3elDU]

+1, just stumbled into this and had to look here on GitHub.

Discussion https://github.com/simolus3/drift/discussions/3691 is also related.