Documentation issues with `halign` as `outer style`?

[Explorer-cc]

The issues arisen from my answer here:

\documentclass{article}
\usepackage[paperheight=10cm]{geometry}
\usepackage{tabularray}
\usepackage{showframe}
% https://tex.stackexchange.com/a/680307
\NewTblrTheme{naked}{
  \DefTblrTemplate{foot}{empty}{}
  \SetTblrTemplate{foot}{empty}
  \DefTblrTemplate{head}{empty}{}
  \SetTblrTemplate{head}{empty}
}
\begin{document}

\begin{longtblr}[
    entry=none,
    label=none,
    theme=naked,
    halign=l%<-
]{colspec={ll},hlines,vlines}
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
    A & B \\
    C & D \\
\end{longtblr}

\end{document}

It works, but in the documemtation, there is no envidence that halign could be accpeted in outer style:

Here below is the code:

tabularray/tabularray.sty

Lines 4139 to 4166 in 6b921ea

	\__tblr_keys_define:nn { table/outer }
	{
	long .code:n = \__tblr_outer_gput_spec:nn { portrait } { long },
	tall .code:n = \__tblr_outer_gput_spec:nn { portrait } { tall },
	halign .code:n = \__tblr_outer_gput_spec:nn { halign } {#1},
	baseline .code:n = \__tblr_outer_gput_spec:nn { baseline } {#1},
	l .meta:n = { halign = l },
	c .meta:n = { halign = c },
	r .meta:n = { halign = r },
	t .meta:n = { baseline = t },
	T .meta:n = { baseline = T },
	m .meta:n = { baseline = m },
	M .meta:n = { baseline = M },
	b .meta:n = { baseline = b },
	B .meta:n = { baseline = B },
	valign .meta:n = { baseline = #1 }, % obsolete, will be removed some day
	expand .code:n = \__tblr_outer_gput_spec:nn { expand } {#1},
	expand+ .code:n = \__tblr_outer_gconcat_spec:nn { expand } {#1},
	headsep .code:n = \__tblr_outer_gput_spec:nn { headsep } {#1},
	footsep .code:n = \__tblr_outer_gput_spec:nn { footsep } {#1},
	presep .code:n = \__tblr_outer_gput_spec:nn { presep } {#1},
	postsep .code:n = \__tblr_outer_gput_spec:nn { postsep } {#1},
	theme .code:n = \__tblr_use_theme:n {#1},
	caption .code:n = \__tblr_outer_gput_spec:nn { caption } {#1},
	entry .code:n = \__tblr_outer_gput_spec:nn { entry } {#1},
	label .code:n = \__tblr_outer_gput_spec:nn { label } {#1},
	unknown .code:n = \__tblr_table_option_key:Vn \l_keys_key_str {#1},
	}

From the documentation, that is hard to realize that halign could also control the longtblr's centering.

My question is:

• Whether I missed some details in the documentation?
• Is halign=l the "correct" method to left align the whole longtblr?

[muzimuzhi]

• Whether I missed some details in the documentation?

Seems like a doc issue.

halign was added as one of the outer specification keys in
2765a55 (long/halign/valign also in outer specs, 2021-06-24),
but it was never missing in the table "Keys for Outer Specifications".

When the table "Keys for Outer Specifications" was initially added in
5e61d6b (update manual, 2022-01-28)
it contained four keys: baseline, long, tall, and expand, in which baseline was renamed from valign, see
92e6e55 (rename outer specification valign as baseline (#72), 2022-01-24).

You can find use of halign = c in the initial outer spec setting so the outer spec key halign does exist and is working:

tabularray/tabularray.sty

Lines 3449 to 3453 in 6b921ea

	\tl_set:Nn \l__tblr_initial_tblr_outer_tl
	{
	halign = c, baseline = m, headsep = 6pt, footsep = 6pt,
	presep = 1.5\bigskipamount, postsep = 1.5\bigskipamount,
	}

• Is halign=l the "correct" method to left align the whole longtblr?

Yes.