pkg documentation

[Yuet-nan Wong]

Strange that something as important as a package management system doesnt have up-to-date/accurate documentation. For example, this is the first item in google search for "FreeBSD pkg"
https://www.freebsd.org/doc/handbook/pkgng-intro.html (useful for rudimentary use.  This is official 
https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/pkgng-intro.html , both 23602 characters )

https://github.com/freebsd/pkg  which is inaccurate (MANIFEST is not in UCL format)
https://wiki.freebsd.org/pkgng also inaccurate MANIFEST is not in YAML format 

Then I wonder what changes are planned and how can I advocate for FreeBSD to other teams. But there is nothing to describe what changes are planned.
So I looked around.  Perhaps in bugzilla or github has some clues?  But now I find 336 open issues at
https://github.com/freebsd/pkg/issues has 263 open issues

https://bugs.freebsd.org/bugzilla/buglist.cgi?bug_status=__open__&bug_status=New&bug_status=Open&bug_status=In%20Progress&bug_status=UNCONFIRMED&list_id=386277&product=Ports%20%26%20Packages&query_format=advanced&short_desc=ports-mgmt%2Fpkg&short_desc_type=allwordssubstr 73 non-closed issues

 but there have been 4 releases in October 2020 and 7 in Sept

I worry that choosing FreeBSD might be a mistake.
This all started because I get 
pkg: Failed to execute lua script: [string "args = {}..."]:11: attempt to call a nil value (field 'stat')
pkg: lua script failed

when I add packages on 12.2R, and from https://github.com/freebsd/pkg "Script MUST be in sh format.Nothing else will work."