From ede9d4f2146add58a0f51a63c67a138c6c6d6753 Mon Sep 17 00:00:00 2001
From: Edvard Rejthar <github@edvard.cz>
Date: Thu, 24 Oct 2024 19:48:00 +0200
Subject: [PATCH] docs

---
 asset/choice_enum_instance.avif          | Bin 0 -> 1603 bytes
 asset/complex_example.avif               | Bin 0 -> 5690 bytes
 asset/complex_example_missing_field.avif | Bin 0 -> 2774 bytes
 asset/list_of_paths.avif                 | Bin 2023 -> 2061 bytes
 asset/tag_choices.avif                   | Bin 0 -> 1367 bytes
 docs/index.md                            |  10 +++++++-
 mininterface/mininterface.py             |  29 +++++++++++++++++------
 mininterface/tag.py                      |  24 +++++++++++++------
 mininterface/tk_interface/utils.py       |   6 ++---
 mininterface/types.py                    |   6 ++++-
 pyproject.toml                           |   2 +-
 tests/tests.py                           |  15 ++++++++++--
 12 files changed, 70 insertions(+), 22 deletions(-)
 create mode 100644 asset/choice_enum_instance.avif
 create mode 100644 asset/complex_example.avif
 create mode 100644 asset/complex_example_missing_field.avif
 create mode 100644 asset/tag_choices.avif

diff --git a/asset/choice_enum_instance.avif b/asset/choice_enum_instance.avif
new file mode 100644
index 0000000000000000000000000000000000000000..46046c1b685f09694fd11e7c789c6b19eb24c45b
GIT binary patch
literal 1603
zcmYjN3pmqj82@jEO>0R+GLxbUvb7~m%H@>kjC2*IW-R~O+M10mk=fZeks+j$Yr4Ch
zA~n=Hrea;rNm3!5uCu~iPog^it*7Ul?|I(u_rCA%_q~@70027%PspLgfeZjTI%I(i
z0t=)uDBc7g0Dv81Me}Gn4mwL>qL|$8E&y;qI`4<CLnavcqYQ=v@>qHf2HnmelTFt}
zKLG$7&}ATls{z0u42ty;tR4a)<okf&0sSO;#u^HubrRhRS{$C>%Vx6m1N_H8w2tv+
za$;yYr8UTn{$2q9Ff_h^sqd-l+5&R890-d*4xJ65IT*`{hER91AZvomlmiMtUBUo~
zL_&b3#Swf(09u!tLuWI&2k1-zR1w-E8A?HmewV}kC$`av-J#aLI)~3aKxT2G_v$Yn
zG99FI$g#p$UNkF~3~4|nNaG60v>)T!f*h8959le>1ObDK5da(kGn5(w03x3iMdO(P
zCPr4+*Mm>DtvCla&4M8|_c{r>m+sk)E9rdrx#V=R{EKfaZlG4aW@+)}%u&a0kIWJr
zG^gtG$b#&Obc{4YCRr7-hxnSRyvmsJ7@#<0fqT4a3JgRF!_;g1g1y<mdU%A{=;N?^
zMbpQ(ST4tp2gYt`c$Km^!+E^rYugit?x6B0`w5l7Ul&^KC;ikRUMl-CcHEE{HdKYa
zZCz^NO)BmUDV9Wv$E|0iFng;2@`-lMr+Y-|*4jtl%=O_H9sKKB2_5mLK8Ez1M>V^%
zS##Ja_@_oqK4IxvK+4VU*+xkXF+5W3ivQrVJr##4>d;ctOtGtv2QR?wGD{Ntv!Jg%
zp^O~179(ODZDg_AE6saWCjE}4dF>l<wb;-WwsY11eanpsN0$^2>CRX71nA35^j~J@
z<%LgP(QfqfU3k|wMEEW*C2l!Yh{1h($?R=VCK8c5CJhTeTigxA&C9+u!E*_XEUCe2
zVrIX1$Elo+d>CXJoqVeB8g>{JnW(7!IC%?+uaNU4W&?efhExB@UfXVk$i)n%jR#GO
zT@%U2NaJ6O5{f3>Z6))AZTQqjSdF8(u{#|tOAAg)pVdD?&`Nt+F4ifx6x2*F{HI})
zzm1!CW8P6lRY1a7Ze$*a<;Ht1bQcdUblY{<D9<+ix}SL4QI)pCv8Bzt-=uJQavJsN
zN+(f*44mhYihtT#yOp0aKR;*s{P_c4qL!WHbtRMYE@HsdZ<hpX5y<-)dsmBYEF<iY
zye_=%A$lNXe<fSAjvf@f#-Dkc)xG!6j8&8lcz{`{g=X?5>JVmCI;F-d-8vkRJ6P{8
z5zxA}`?^%GDC^y4Q?GOZx92OgM#tMeJ-busP;ey;k6uTyFn%A`!I#0Q0`E*}^T@hl
zhCE^<Etg~Ub!ZHhI3&9-^5Z3$^w~F+WLEgDlq75o*fjN_c+=T@r(f!@>pql=lgj&Q
z?q+wqo1&hXK?QQ0)vgKsQ}I_x>47nk?+q39{mjga6ynRqH7dChX1Y?&pZQ>D|KCUC
z=6%D2N|WJ|&_m9jiw7_74=k@nqZR!Vqu;XYRMf^@F4gNl)(V@K90}X4iHM4ySdj0&
zaq0P21-BJrJ<kZ&>O!lpsGXW3N}Zid4DP%gfUUKi^z7sbH%gkqe@%XI!)ZRa^U<Y&
zV}AZ&ER>_~irV*-D4ce7K$}x}<I;o9&lPbms^fNB+F%6_3J)$429H|$2IWo@mD;Y$
z)!0Rup<f!xW|X{;?XjCXU-brCy6&>4kCmmIm?t>V?YX#;VUfJpj7ZEJDG2F&>^Yp>
z`P}J3RJWtD_0oNT-7`z+2F>t7)={^aC!ZXSX%pYvcX_Sao6;vvwk3^~6~7G{ncJ;V
z)vM3FF<zuW|JH&b4cuOGS{<<Oblvp{BGJ{&PNZzUX0x$u_xRP%vH;Tp((0*;Gf<5g
z9+4##vc&xzB$YTM$JmNnFfDvJB+&@stNQ#Es96Dw>!V{NO_wqv4>!v1t?E{%?2u%L
W%QeihlvHVqLN-=f_%O@uu-CtV4U$Iy

literal 0
HcmV?d00001

diff --git a/asset/complex_example.avif b/asset/complex_example.avif
new file mode 100644
index 0000000000000000000000000000000000000000..81787093503ccb728475cb5338cb16c2bde89cdc
GIT binary patch
literal 5690
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
M)xXQfM(PRr4`z~eAOHXW

literal 0
HcmV?d00001

diff --git a/asset/complex_example_missing_field.avif b/asset/complex_example_missing_field.avif
new file mode 100644
index 0000000000000000000000000000000000000000..b7e1b71f94a9de37118a714397c4b04981d50fe2
GIT binary patch
literal 2774
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
K{}knWm-b(BlEtV1

literal 0
HcmV?d00001

diff --git a/asset/list_of_paths.avif b/asset/list_of_paths.avif
index 573151294aedb8cc966059683e99c09e0875b191..df99f7ab40aa0c4aaf02b3f57d852048d7cd12f7 100644
GIT binary patch
delta 1496
zcmV;}1t<FF4~-CzdK3cv000FL00IC2009610kr@C0Z5UKdj(Jc006s_4gsPOU~Ob!
zbP@mx1{fjf_e?4>yOY5Ig?}UqUj)%S0)yIx<&F={Xq$eN18}$W!)_1|pQN;%(b2yg
zst|ZXgEl)%xaP74<53IX*rEK0rKF|SKapTWB=a^+$pY#Tq(q5I04j2IE?2H3Go0O;
z77sjAz}|uL(yxKi=eVHmX_oU?MCa^zB-;wUUujq1sxhE~#fPp?_ein|+6uBiKJDG(
zSVUV~qfaMz`Q^7cTPs<zL-l1834j86r{&6#m-BOkQyd5MMead4hw{|GPoNS23JMq@
z>Gw<!ARrh(GXIkn13iD7eDWZL{w7Lde4f?kzmwp`l;<+I<q@{ugJH8?T^$`h!vD?L
zI$1~~ECCX;i|JST#eWC>bn>+!sk6#Gky%GJnWl^akYp^yGFVT-6ckd~uTdkKY6b#o
zRwXS-iYUZQ`=TntKIrtg)P_|#_vO4bm->ApC}~Nbgp2{>@V<W%epkC-%P(~!tVZC^
ziXaCy_j6eN#`w>D2wyk3s!_^+lgPrq|5blS6OOfih~juWiFA8Or71!7<<S=RCqX4d
zyA9hU>ik;hqipi%_7tUYZL+N3DFF3;xB&5N(RQMOA1gbD4U$%7sZ-i~j$8<|dN-_G
zaTW;ap6}Gp*zkY5dw*)+w5OXXUmyCp@C^xeBzoR3pTY7k&)dYYQ3KtpZ{D6;_7%=9
zF)UsT48qqM*PEugeX5~7@ruD{ZYb9orn1D?n1KLiuee1*$+Z!J%zfd~QbfWqT|?oW
z<>MlI|6OBamq%4PB=M^C&rDon;=I?=fm+&PhH|6u1=D{HxxO_AYDWJk_;2{xQ(u2m
z9hIDC&o$k$FMx2V=|aE<K#@nx;_Ny=fWW;wUYsk(O{SZ}cf1_<f^6OnwinG!@n;JR
zI~9?m6U#hTs)Y|_!u)I`ocWAX-u}p|<P<C){v3rf2|2Zip90t$B0}cA0S+Ba;=m2^
zua*U&rAL4MkZNF8?!QFA34TkmU;7JahA=7tqH@)a>KbZ{yd=|S+NLt&urYlpaX^64
zKUH@DNF8OI=`Icf-!(I;d&+gEGmyFtzKI%_5Y14XexTBJkLyUzTwanVuwXW_j*Cxq
z>}q>4*ykJGHE9mfVwUTdc13qg*3HePiY$A)tT%r{%wjTH?8Cz>fA)r9X>^Iw(mk|!
z6!psFnf0)h#OEQD2w8;UTUB&#CT$2#Z25$oblxg}F(dzs2EW3Wg|$2R0S@~47N4<F
z26=WsY|$RCU{@0A@_m-S#`dVNS1rX*tfF(vH<Lr>F_sF2MY>LN=vUn8f6KcHpo?;7
zjL&~g*GrU#3$RQq0MB~vgJ)!M7+nMfPE4zYmikql4Q0TWVfMG`liFyDXH^%)!qVSD
zmfIrAshdv{F+=&elWhlK`Hv%h6=&G~f3U>0n9cyFh~+Ho`V&4?Ry+zCW$MX=Re%Qs
z>==DpAJuZ!Y9+jjyY88svHd*o&<OWGn!<ljBE)G=DO>gSE6OVw2-on~{~(_6!PylA
z_jM!~<4|M<p&SWtS-*3D01i*7MPxijV87Ev@0cKJSEbZdz`U_*lnpi-mNBS)3Wx}8
zg#e%vF)w1od<2uwu#A&sq1K;Aa}i!{?*B(sM3(8(M84?tbzB(7>o1+qq6S_}q^^I3
z4DFf2AlJD}{Pd1UZHUn0Tp!J^4SsEVYVPQ-Plk53PatA&OeAfX=ex0K4?<by41k0)
zd#TLb+FX~}nuOV)vsOdNTq1=BJHO0P!2jf)9|xZ#GBe+o3(o06k|9;jo0mAmcW3H9
z7Ach1-;;NO`n-d_nGXKTj)E*L?tM)Bf>T}=81L#wQ+UB9{eF{>IE#lNOp(htgBI|x
y$P%ly^X5^pz-S90%{mWTHw$s$^KB%2jKz{yorXho_}JoQtc?Y3XmC#?Tj-GKR^HnH

delta 1458
zcmV;j1x@;m5a$n&dK3c&000Ex00IC2009610kr@C0a1~Tdj%%|006I(4gsPOI&EZO
zbP@mx1{fja)yyg~#FN1Rg?|>r<R~d@7-Gq*8Sc!>d^^aQ2hikd$1ViR`=UFIiuM2f
zgi#;dIwa^Qu&wBoDqsA9=AS7cLu_Seeu=oj&U#v;;<auFfWWV5avN&Kx1A1j6lb5w
zUYyk%T>jJ*#w-u;=?0A#pr}L<n!y?pjz(C7tci(Hz#XI(?Eno`xl!J>5MYK;wP!B2
z<(>qeYiu*vocN8@@xZg&mT$}y{hRlL3V=dyK0Qza6yTF%@PmduVGLyZi!HiOV<ftl
zPNRSl0165iA>`G}5Fj8JKr+yi4Ff%YpIatrI@Jk*1w}=ZNLgmgwNlJYCybu>LE1fb
z@<3<`Im^Tn<k;_ZsSu=5=Oe^IL-*%_#7z^mpQG0XROE&Cuj7z8j@U>4NWFW2ZAvse
z->kx+5JGQfum-xZWnU!1(P88f3Aze~;o^SChUC8ey!o5PgexWR%sPpOYWt0UkZ|&<
zi5Q&Gj<TaF#1bJU2Q`#iAcZ?4GAlFmmRR475YmmT7<q}?9dpYt3NBu$^uxaUF6}2M
z_nU$8&ZP{3A#@R7VJ7;SuKsW<?9I(eYXbsRc7ZnQkJgr_?V%=MpZPe+yFH3Er4;}$
zSic!@{}}G2u7AkA*x>+Nhj|cxaxZcQl2yNHmw<FTF?ST@X+lBmV5j(+CfDsqEW!)E
z5zrqkE?6oCsVIZdnDJI}7d?vOdL0)@^5{FE^J3t;>`mO?u&G~WNU*mb9FGQ(gY9|B
z0H2<Fl-QAE2*;-LiE);kBocX<O}0P}55WSUE}&2m1FZPRNpcjROaan=i^{_VDopLT
zy2bUsQuN<~v#nWzU>eK>qgH{nT1!y`P*@h)9<Y0RVt&V5#K@;ih%9)KZ@^yinyEwJ
zB25ae741Wkz3;Z`H~ch?jlwQ#hFk}yqJ41D#V}A%!?sFRC-72&SjQri3;Up#i8<eP
zZdH*kl4PxLMcfzS7PS?B3*fJmiAs{~B(o*{#aHAo^t&ap!zrz-(`yLgpAM}-1w3Hc
z)KIMvEAdNtbq5<$NO_`WDk){aCX>Ft|3sexzNk%Z-ed_&J6gsyGYAt{gk}{g3zWrD
zjh42KGT~@SPyi=;5@5_0bQ}|t3bA=b#GLIz@XBT+gBV+WLWoL#J-Y;e?*FjAFR#w}
z1qu=V@s36A%2DOKQj4MA;`mX<PM{?N{Rd>c#-zGQW$`rILPqZgU}lcVuY0prJ&l{D
zYiFZ&q)_DCS?Afl@8uVBtj?uw`%{pR&k}u|{-X;)+bw_mqe+Y1c`3PoZjt}#p?4-3
zFF2=P^j>y9xh-ISKENyQ{Ge32anbt$SX3X)2_%vr%q|-r;w1r~l8WmFl`4xlW;x~=
zYNVpahXv=x>k8iS220n<VDxdO#UCqU=ls|r{Bs}qLtYwOL}VgXyzfKX<KEv*5XMo3
zgo8d9&sM37Ltw5;6Y~2i(a(lFH)*4UddrZkSa3u^CXZu(+lDe-w4E{k4V!$4<&YS&
zi4i=Tk=G4@OZE?E^f25-dm6=rZEg7>XX!PCd9xPTg@0VhMf|1CDST~-T*RKX_9<FM
zB&uJSmZmnos{V&%oq6*nnmCi|$LDg*MR3#_O)50;5yd-64}iFY5)##TQ<Uzl63&=1
z4`wm#r;rza8uC1Js0E4{-@qtPb_%_!jk5viWQP&?t**==T-z@s3)Wd8=?Ad4bkjC-
z(i|vv4*&LHE4hA)U56EzCcbNuftGB7PcJa9NzgjDbHQ@)Ru4^^_$XHi$Vo*|rdb>U
z+p;6O#MXM9#rbRC2Z{ay>RsZF8XB(4|3_om=|RLDld_mN9beY^Q~EJ0OB|KVHNxU-
MA82-H94d0$<cLAN%m4rY

diff --git a/asset/tag_choices.avif b/asset/tag_choices.avif
new file mode 100644
index 0000000000000000000000000000000000000000..b1e3dff8a70b7b8186ca77c4e318736712ab8621
GIT binary patch
literal 1367
zcmZQzU{FXasVqn=%S>Yc0uY^>nP!-qnV9D5Xz0Yiz}TCcT9OEo0|JeVl$;_6lYyZi
zGr0uD2GKd0Nibvh3NlM_!E%g1QYSMfKN-YxVPIfl0EqxG({&(j0P?{+#;rg~3CMQJ
z%*+G31S}&3<fMX>fOI6585la}=j4MOfRF)7gJc|Y3NjKwDy1@uQXwWVFz_XoR^))~
z1lf8xv!JK|NYBkINX`e+BALYnsX!V8ih+0!5DOG!R%C(%m^nB&fD}(+nW1wd0}n_@
zI5|J3C@(pu0%#)89}PeuphqFf8IcsrfD~H*t#$@6N{jNWatl(^!Gx1la%OUYRdHo;
zNosDf6;MrPPG(|JrBx!#`Er>BxnO?)wE`_+VPtA%VPIlmWNl*yI%-vJN@9r+0~ecw
z<j>d*D~zTx2~1#Q3An3Waa%JXRDS-|^S|aVYS{JHxmf<~hFvzA^8)%ltNp(uRIU1I
z_SUIZ6%$u?^R>nGx0**J7(b3ZvMuem^;<s^*|kRkMOCk_H$3!x$7&%CAu|KdYIjTJ
zWe=leO1jR4K2Ui5@##TTcHe5wP~~4sAKkNg9S{(1s}TCPXlA$WHPfvt8JaI#l~P&h
zxM>=j#MCo(5_y43=Y(ln>^N=|o+u{JcFN*vuSuGUQmABl+ws(;wR`L@{e1H*T<Wj-
z_oK3Ji_M?MNOsrWy;ZKBa<fM6t;EEo+gzVDwbeclv)*hlSvBdhuyWD8yR+sp3f0Fp
zXolbK&*q(Ht<00562B{F?UI<EjW(+u#AYkp{cvnqjn_#rbNvor2yuc#$f2Pj(dYw<
z%L%4gnM(q$|5x*oX2{!ne}(bo`~M&0+;f)Sp}eH%QD!6~@9AAHVi);tni<1<^KtjC
zosKd*3BPzvZ^%Z7mdUd5S1GsUADzND|H8EyO*(>>T>JI+gvxD5XS&*aKz#MLn{tLH
zUKk(0x@gm8zwaiEg|n;-g6@0ro0?eLEnCHE>EiFTHpJXjQ(_|9mq)wR_t-tyw=1)`
zX1V1%3E9xc4%Ox>_d0OiQeANPtCUikjQ0K|pEPuQ#FDR^J+kb-)XL`zZl*f2Y}E9V
z;Pdgz-}b9g=IEA+Pq+3gNnP)kSj_5lRQ<!LkHPDOp6aenR{Qh(5nq$zzPX-H_}o_c
ztd&2&@Qf?&$tpe0scMTaR-X}l8UFujgLB<Xb*|dn{U_#^eo$mBE#3R6$zgwV-;Z0V
ztZc3azx*spFu$^UyP?eEd9thXk1lxf>#otw-PywH)NEQ+{|Wt{zxb(}=%oD{Hy-5{
z-}B(Y`dLTXk|pE&IlPv{dcNk~_x+{*lS`tSE)8$m8=R7y%l{q!^ZEU{;2pbu{L9mA
z%+mF>`<fu4yvA;Oz1VMl-nqVBMf<{~x7IygwRyAVo38IGmkFe=TrJ!1WSdyKXhVgq
z{aHoNi2()6pG@IPXwqVhR$_BkYh&qg`4)9$@^*<+Rkl+%&F*zN{Mu-u(ubm*bqDTB
z37$Hcsp4^9O%QWojLEH?D-F#jShH_`cSd*W^+!j=_jL=*o)A83_O~RD-V^WndW3&Y
zcsi?HqjVNy*7PG%lTyw;a_Qb<d&#YPug%-N=Udj#{G{Z5Iq<|u&RMHeXUnL(<#%TI
oW%bGC?p6Pb<v}JY_FE1-II{BtXTk2;zK4mkJ}t0Td#<-10NXAT@&Et;

literal 0
HcmV?d00001

diff --git a/docs/index.md b/docs/index.md
index b6ceffb..2dc2981 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -119,7 +119,7 @@ class Env:
   nested_config: NestedEnv
 
   mandatory_str: str
-  """ As there is not default value, you will be prompted automatically to fill up the field """
+  """ As there is no default value, you will be prompted automatically to fill up the field """
 
   my_number: int | None = None
   """ This is not just a dummy number, if left empty, it is None. """
@@ -143,6 +143,14 @@ print(m.env)
 m.form()
 ```
 
+As there is no default value at `mandatory_str`, you will be prompted automatically to fill up the field:
+
+![Complex example missing field](asset/complex_example_missing_field.avif)
+
+Then, full form appears:
+
+![Complex example](asset/complex_example.avif)
+
 ## Form with paths
 
 We have a dict with some paths. Here is how it looks.
diff --git a/mininterface/mininterface.py b/mininterface/mininterface.py
index 3ad0cde..4889ca6 100644
--- a/mininterface/mininterface.py
+++ b/mininterface/mininterface.py
@@ -16,8 +16,6 @@
 
 logger = logging.getLogger(__name__)
 
-# TODO readme examples refresh imgs
-
 
 class Mininterface(Generic[EnvClass]):
     """ The base interface.
@@ -161,7 +159,18 @@ class Color(Enum):
 
                 ![Choices from enum](asset/choice_enum_type.avif)
 
-                TODO Enum instance
+                Alternatively, you may use an Enum instance.
+
+                ```python
+                class Color(Enum):
+                    RED = "red"
+                    GREEN = "green"
+                    BLUE = "blue"
+
+                m.choice(Color.BLUE)
+                ```
+
+                ![Choices from enum](asset/choice_enum_instance.avif)
 
                 Alternatively, you may use an Enum instances list.
 
@@ -185,6 +194,8 @@ class Color(Enum):
             The chosen value.
             If launch=True and the chosen value is a callback, we call it and return its result.
 
+        !!! info
+            To tackle a more detailed form, see [`Tag.choices`][mininterface.Tag.choices].
         """
         # NOTE to build a nice menu, I need this
         # Args:
@@ -198,15 +209,19 @@ class Color(Enum):
         #   (possibly because the lambda hides a part of GUI)
         # m = run(Env)
         # tag = Tag(x, choices=["one", "two", x])
-        if skippable and len(choices) == 1:
-            if isinstance(choices, type) and issubclass(choices, Enum):
+        if skippable and isinstance(choices, Enum):  # Enum instance, ex: val=ColorEnum.RED
+            default = choices
+            choices = choices.__class__
+
+        if skippable and len(choices) == 1:  # Directly choose the answer
+            if isinstance(choices, type) and issubclass(choices, Enum):  # Enum type, ex: val=ColorEnum
                 out = list(choices)[0]
             elif isinstance(choices, dict):
                 out = next(iter(choices.values()))
             else:
                 out = choices[0]
             tag = Tag(out)
-        else:
+        else:  # Trigger the dialog
             tag = Tag(val=default, choices=choices)
             key = title or "Choose"
             self.form({key: tag})[key]
@@ -321,7 +336,7 @@ class Color(Enum):
                 ```
         """
         print(f"Asking the form {title}".strip(), self.env if form is None else form)
-        return self._form(form, title, MinAdaptor(self))  # TODO does the adaptor works here?
+        return self._form(form, title, MinAdaptor(self))
 
     def _form(self,
               form: DataClass | Type[DataClass] | FormDict | None,
diff --git a/mininterface/tag.py b/mininterface/tag.py
index f0e8c3d..4e1dfd5 100644
--- a/mininterface/tag.py
+++ b/mininterface/tag.py
@@ -53,7 +53,7 @@
 Either put options in an iterable or to a dict `{labels: value}`.
 Values might be Tags as well.
 
-See [mininterface.choice][mininterface.Mininterface.choice] for examples.
+See [mininterface.choice][mininterface.Mininterface.choice] or [`Tag.choices`][mininterface.Tag.choices] for examples.
 """
 
 
@@ -67,7 +67,7 @@ class Tag:
         """
 
     val: TagValue = None
-    """ The value wrapped by Tag.
+    """ The value wrapped by Tag. It can be any value.
 
     ```python
     from mininterface import run, Tag
@@ -83,6 +83,14 @@ class Tag:
 
     The encapsulated value is `True`, `tag.description` is 'This is my boolean',
     `tag.annotation` is `bool` and 'My boolean' is used as `tag.name`.
+
+    !!! tip
+        If the Tag is nested, the info is fetched to the outer Tag.
+        When updated, the inner Tag value updates accordingly.
+
+        ```python
+        tag = Tag(Tag(True))
+        ```
     """
     description: str = ""
     """ The description displayed in the UI. """
@@ -133,7 +141,7 @@ class Env:
     """
 
     choices: ChoicesType | None = None
-    """ Print the radio buttons. Constraint the value.
+    """ Print the radio buttons / select box. Constraint the value.
 
     ```python
     from dataclasses import dataclass
@@ -143,14 +151,17 @@ class Env:
     @dataclass
     class Env:
         foo: Annotated["str", Choices("one", "two")] = "one"
-
         # `Choices` is an alias for `Tag(choices=)`
 
     m = run(Env)
     m.form()  # prompts a dialog
     ```
+    ![Form choice](asset/tag_choices.avif)
+
+    !!! info
+        When dealing with a simple use case, use the [mininterface.choice][mininterface.Mininterface.choice] dialog.
     """
-    # NOTE we should support
+    # NOTE we should support (maybe it is done)
     # * Enums: Tag(enum) # no `choice` param`
     # * more date types (now only str possible)
     # * mininterface.choice `def choice(choices=, guesses=)`
@@ -235,7 +246,6 @@ def check(tag.val):
 
     def __post_init__(self):
         # Fetch information from the nested tag: `Tag(Tag(...))`
-        # TODO docs, test
         if isinstance(self.val, Tag):
             if self._src_obj or self._src_key:
                 raise ValueError("Wrong Tag inheritance, submit a bug report.")
@@ -583,7 +593,7 @@ def update(self, ui_value: TagValue) -> bool:
         # other interfaces does not guarantee that. Hence, we need to do the type conversion too.
         if self.annotation:
             if self.annotation == TagCallback:
-                return True  # TODO
+                return True  # NOTE, EXPERIMENTAL
             if ui_value == "" and NoneType in get_args(self.annotation):
                 # The user is not able to set the value to None, they left it empty.
                 # Cast back to None as None is one of the allowed types.
diff --git a/mininterface/tk_interface/utils.py b/mininterface/tk_interface/utils.py
index de5128a..3a73a11 100644
--- a/mininterface/tk_interface/utils.py
+++ b/mininterface/tk_interface/utils.py
@@ -114,16 +114,16 @@ def _fetch(variable):
                 widget['values'] = list(tag._get_choices())
                 widget.pack()
                 widget.bind('<Return>', lambda _: "break")  # override default enter that submits the form
-                variable.set(chosen_val)
+                if chosen_val is not None:
+                    variable.set(chosen_val)
 
             else:
                 for i, (choice_label, choice_val) in enumerate(tag._get_choices().items()):
                     widget2 = Radiobutton(nested_frame, text=choice_label, variable=variable, value=choice_label)
                     widget2.grid(row=i, column=1, sticky="w")
                     subwidgets.append(widget2)
-                    if choice_val is chosen_val:
+                    if choice_val is tag.val:
                         variable.set(choice_label)
-                        # TODO does this works in textual too?
 
         # File dialog
         elif path_tag := tag._morph(PathTag, (PosixPath, Path)):
diff --git a/mininterface/types.py b/mininterface/types.py
index 85de0e8..16adb14 100644
--- a/mininterface/types.py
+++ b/mininterface/types.py
@@ -7,7 +7,8 @@
 from .tag import Tag, ValidationResult, TagValue
 
 
-from .type_stubs import TagCallback, TagType # Allow import from the module
+from .type_stubs import TagCallback, TagType  # Allow import from the module
+
 
 def Validation(check: Callable[["Tag"], ValidationResult | tuple[ValidationResult, TagValue]]):
     """ Alias to [`Tag(validation=...)`][mininterface.Tag.validation]
@@ -37,6 +38,9 @@ def Choices(*choices: list[str]):
 class CallbackTag(Tag):
     ''' Callback function is guaranteed to receives the [Tag][mininterface.Tag] as a parameter.
 
+    !!! warning
+        Experimental. May change.
+
     For the following examples, we will use these custom callback functions:
     ```python
     from mininterface import run
diff --git a/pyproject.toml b/pyproject.toml
index def4ce0..18215e2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "mininterface"
-version = "0.6.2rc2"
+version = "0.6.2"
 description = "A minimal access to GUI, TUI, CLI and config"
 authors = ["Edvard Rejthar <edvard.rejthar@nic.cz>"]
 license = "GPL-3.0-or-later"
diff --git a/tests/tests.py b/tests/tests.py
index d1202f1..37dd32d 100644
--- a/tests/tests.py
+++ b/tests/tests.py
@@ -204,11 +204,12 @@ def test_choice_callback(self):
 
         self.assertEqual(50, m.choice(choices, default=callback_raw))
 
-        # TODO This test does not work
+        # TODO This test does not work. We have to formalize the callback.
         # self.assertEqual(100, m.choice(choices, default=choices["My choice2"]))
 
 
 class TestConversion(TestAbstract):
+
     def test_tagdict_resolve(self):
         self.assertEqual({"one": 1}, formdict_resolve({"one": 1}))
         self.assertEqual({"one": 1}, formdict_resolve({"one": Tag(1)}))
@@ -421,7 +422,6 @@ def test_tag_src_update(self):
         self.assertEqual("moo", m.env.test)
 
     def test_nested_tag(self):
-        # TODO docs nested tags
         t0 = Tag(5)
         t1 = Tag(t0, name="Used name")
         t2 = Tag(t1, name="Another name")
@@ -448,6 +448,12 @@ def test_nested_tag(self):
         self.assertEqual(5, t4.val)
         self.assertEqual(8, t5.val)  # from t2, we iherited the hook to t1
 
+        # update triggers the value propagation
+        inner = Tag(2)
+        outer = Tag(Tag(Tag(inner)))
+        outer.update(3)
+        self.assertEqual(3, inner.val)
+
 
 class TestRun(TestAbstract):
     def test_run_ask_empty(self):
@@ -788,6 +794,11 @@ def test_choice_method(self):
         # list of enums
         self.assertEqual(ColorEnum.GREEN, m.choice([ColorEnum.BLUE, ColorEnum.GREEN], default=ColorEnum.GREEN))
         self.assertEqual(ColorEnum.BLUE, m.choice([ColorEnum.BLUE]))
+        # this works but I'm not sure whether it is good to guarantee None
+        self.assertEqual(None, m.choice([ColorEnum.RED, ColorEnum.GREEN]))
+
+        # Enum instance signify the default
+        self.assertEqual(ColorEnum.RED, m.choice(ColorEnum.RED))
 
 
 if __name__ == '__main__':