From 8fa5e58c50314fb7e9271aee3ead275c186cefcf Mon Sep 17 00:00:00 2001
From: "lina.wolf" <lwolf@w-commerce.de>
Date: Sun, 21 Jul 2024 13:01:43 +0200
Subject: [PATCH] [TASK] Update documenatation on include directive

---
 Documentation/Images/include-with-button.png  | Bin 0 -> 11912 bytes
 .../Reference/Menus/IncludingFiles.rst        | 136 +++++++++++++-----
 .../Reference/Menus/_Include/_Content.rst.txt |  14 ++
 .../Menus/_Include/_ShowButtons.rst.txt       |   8 ++
 4 files changed, 121 insertions(+), 37 deletions(-)
 create mode 100644 Documentation/Images/include-with-button.png
 create mode 100644 Documentation/WritingReST/Reference/Menus/_Include/_Content.rst.txt
 create mode 100644 Documentation/WritingReST/Reference/Menus/_Include/_ShowButtons.rst.txt

diff --git a/Documentation/Images/include-with-button.png b/Documentation/Images/include-with-button.png
new file mode 100644
index 0000000000000000000000000000000000000000..981d4bf38fc2f50e56999eff79e8e99618e54dde
GIT binary patch
literal 11912
zcmdUVcU+R+|ETS9HC&OYnVDIR(%dUGHFxfuWQykATco8{DsIW0xpR<vV`d2|?!7R@
znIgGBMc`6?zMtRs-oNi3_dc%|a5&F%o^#%NzI&{v!9;(Bo{o-=N%PS|Lpr*XVzhD2
z+0(Rd3D#^3?dPPUvaT{6T}3Rzq3tQ!|8t&?%zfzSn7{q`9Amqs^@28e$ye=(uaSp?
zZ-A{gh)%;B1akLz?%``=a+bD4gi-UMvT>jdZiec?I!4BC9&%9b8A9rl6_xHQm8vvd
zVzpq^HUZ_aE@OU%zIp~WoY#h1$B*WG2JJ?i%;|wyP^=gYFY)mjSqnXPc^J1p{d3w-
zj%lnKmL~f7T(Rcsl(Q}#@sf*?Ze<9(jJTtJFFI?&JRPJ^n|*#Y`AgOIA{s{a#$=^}
zbxc>5deWDG6DA_C5_7PRSW>s<Y-&P~tDxSa*kJdS_hF9{-eEEphV9G_y^`*z{_@J!
znHG<&*=p8dCTfyWGF+!7_{ou{^DK2)M265IfxYsC<ldd)Af{sWE5w_5qLTPDFRPSc
z+0P&j#m|A~yLlKNZR~rQ|K=9d=1)~9pR868*vI>7_WeAzy7smfX{m>Q<6Jyf^TWbJ
z-&FxEU5-m0U&^mUXI_aD8No~w+yyhz5(g84dZ%hP_dgg<nL0u&mLf*(6A1pey82=A
zWs|C&>OFs#=b1|&V_fXZ^E+!GJ@s1O&ONvI@I>nbx%+&<@Loh2VP;?<_oD-t&Etbh
z!)=OeLu~i$<$E806mAnWL*+g8H*vW)n9dKEY6t0cKqmQvYNFjlS?v#<za_oHF^x<)
zmgDSskc;VwV%2c#8oP8~#aYqtHuv3TKb;0>#c2XntIjB6t>rq7+-@0B;&yuki<wf~
z9D}-Kk8$fukOqz7Q_V(xlM@|g5^RPjhmHDdEgH$O^a*R1P2edV(lD+GjZP$F%U?UF
z=W@Qbo!IYhlAUf&u=17@-cNxV_F?7wQk9}hv3|kGhxY>ejI(XQ4SE35u)JPqc9fgl
zvZBPW{FWuX*cv!P2(`D}7LwRb76gnB@~XnfecUY`j<Xwahb2by`nI)ZuHaWEk@|xK
z5u2+C+`A3=b#}8&;)bD5v);N4E^F-ux-Tg3dRd;aLTa6u;#&m^IZ3}L=rZLwjk-w>
z5Ki3TH?P?aZ9Uk!d(Fs3yoV!N${{ZlSfh}lwV)lpy9m<sQwdng+a5WW+UgN8A~Zx^
ztXt|%$997(G;Z9bmLGgt_Y3Y8+a1dA&1CGleBfoXMU}i>_2Xx^gIh@R;&|rGWmv(u
zuS3SSACou}1dq_2mk09=o?gSGgtS>l+54DUT>NG_bU*p^K0jXHQdi(6PTNtHbnml6
zy3;0Zv|o0WutX*YgjhAc>P<_N#FM8)eNTqp<}fSl;Uo;!Tks$&Tg+3*`-D=du$aNT
zRuNba_VeB*%i77ylr59OZh7Xw_BG#r>$UlY)@$N;0;<-^=Ac)mfVmc|8=|^PFrUHh
zEfx8GX2!l0-!{|>7WL$^V_K&syBA82g{V!EB3svkk#FbSviDq&HGM9#X49lW@Zk-F
zM*64Huo&N~F4fWTU)E8Iw>uXUC7{?neT=&x9H7RLux;50S}?3QXt<c2?LuL~G3+Wz
z5VHN08};cUeFyx~ce1OX86|uPX2_|Bhfm*o{Gs_yi0$t%Yz#-JdSkNE)yHd<x{YTT
zY&LJUx;$L^eCkY9i=m>~8h4>Ko1hH<cA{xGWI;~?|J1Txe&HWFx1sC&EzdXu&ojB5
zuUbzdRy++{2eUu$0hOFTVb2mCouavyV3n23y9*Mgc9ar1JlrTxBB>m$A9Lp~;Y*8{
z^)z~5se58Gzz-Z@18n52r9JP|(Tl}{xPFLQlM-LJRb4d1Jpxu}|8Ys%0LLNZA>&`z
zIr7fhBCcW?w|Xer%!QZ4G!*3^0_)DKxlT?(5E!q->D7u6-)HkA;qsh+q#M=~F)DcI
zvOO##q3^>UVZ4J_PuSEB1`gwO>Sf(9sWJ^=sio`=&ilw_Swu$W>o?>Oh~WX>8Y_*e
zn%%_7#srm!djZu7w!uR-5@kMqtjmfnKcxw^M$O|FlnShnPfm~^`BQ?uyEgFz$^h!#
zd@#@(zdcE0TSn+ehh@O4x=LAh09x6fz0j#zG2S9_wXxIqeNgH&ykJJjsrUBV&(yR{
zhR#jm!Csgr4yH~B&nj2#X*&Fh-!mo6z0AYnBEleRaRZ!76+YP!?+Y7Sh&iWbdVi8p
z`JV{dk!gL)Y(oGzS5<u9NHumiS21zNYv{2?Sa|lGxn|BiSMhCKijX&(*p&(HbKM1T
z$EqLJ9^8E(X@GhTpfYInbp}zRMq5s$%6U+pvFvxp&u88&q25*!WN0H+Xc;(&nu!h;
z;YtI6B3ojfn9x+gzV7d96sO+=j;r|Y?v!Jx!;We~$sh{)*y_XtfJVcfI|PumuqYhy
z0%|1@%hGzdV)Vj9?lg&?_$_dJP7Idm+bXwA<u?a9%#%&z4o-EGt~&vt&k#C`X9Rx8
z#bXf`aI=s+A4gwV@}eA^Y6uR?IT)+a@-lU>=7Q#b(qWFZaEw?HMLRc)!esHotHLv4
z!Tj?6T~ZEZRX5NuRj@^4og$^bK20yWB+<#mQ)#l<EyWb|cyLT}6TwQ<%(kfe?Ro-Y
zO(K?n(*|?={3p@oH}@f&$qi4<55}AFY#5eurqh!U<M)7qy{Nr2l#8tEv)|OJcDi2a
ztVdBn_c7=0a-)m%iVjpLM&cf1*hrKrWp&nXRG?DihbAC6U{vX}gdbx}iCe;O+pWyC
zDDGH{7!uUgd@X~dqbUb%S>0J1yQ;L9&O!mcb-^$UQ|Jl6T%_;osbX(GW2UK_XG9uj
z&8#z($G*IcfL?5|`D+FQSjB3IsOO&kuY#>(Xv=qjLkF%^<u)TP>t@G>?<bP#M#v0c
zzVPT@Arww=hY2?Gy<`YujFs*OuP&Dkxu##IY7}}-3t4X|d0Z#8?IJK=5&dh!o3+j^
zDns|Ffot2n4}MQ)C-W-I{$xDW)1WVGQ=!?)vzYH$-1`k3+M!e?uJ<~-WB_Ln-+)yW
z^Wu{q?S@6<wVSLsbuGV#$WJ-8<U?wUCAnjI#z?N&MPcyY&~RqI=wQ+q&nSxUM7mhi
zvTCVB5rW*^<PPfDhrc{5zqjVY`L+FD(}0C2SHM+gYO6F(L;E7e`X?2$lU^Ze8)PYx
ztBUrr+ZMW!_1CwNy0#CHq(Q}HzuN0uPr(ImM2-hy7xT3tfR<1CCu$MXX`+=4R>}^q
z7FR``mKdV-`ci+Fgk})U?n~%3W33N=zL*sp+#VlX%;Z+utv#qC^Uuop*)Ua64ooRU
zKhKK~F@cQ@fz!hrRZo^b1|ojWK=_{L2E=Ryjd<Pbi!>IP(+QpC1~l2m6eG^|auM-H
z7o&6abGcitaBH*G%zR#}vUY2oJT>C~Y>*xhv!S7#8y>AbT0EH=#a7u&vM<_f*AAb~
z$doLT7qG*Cxn6;m^TELJ&cWN+r!&39p_7nc;F<T!WmpZ+l+B3K+frW@Ue)61%i@{R
zTz=E7io8{=SDrV=Z9Y}L$?O+N`e8}=fEKX6gXglVARzAE5O=WE3}-Cc@H%{I(?N)U
zt9o!+0b>15`yo3-!-B9ye!mOc7CyK?l}lEV|JgGYWFAxbNhKo1KU&_E7dtY5I^1qz
zHfGR%*$7|lL$-vBoFsPrUaguwv>WxCcIq8_vj%?9vaAsc*_~|7@bx|Tg>ZOpH0nb^
zWKbWAj)lSX1A+Qe9L|<2B-v9#;n*kebNIk2Ot%gv`}&xU1+OYsLzPF7UlHaG-#c#j
zjC0hxFx-c4Pyw9JNQHtHOd}sJH!3-rZB39bN!x6g2fhM8sJdj=D(c;zYPhIuXyjC*
zv><t8wM?9HWt`inAZ|m{j3-eX!^80n3s&yfA%+X{?E+`%Qur;wm#?MYvbVQVt5d3X
zsJXagJllvBO&#)Jk+XfzUAPo#tJc?w@pZb*RIMM&0`%n@a%yYLpW$pT%8TJd_tgmB
z-wtgj6&l2>Ba^i(3pE5+jeWIe>=d7qw4iN~sghr&gGzlZ&kXTjO~-hpOX`!;ykZhZ
z3r>$#4E|hmQM)3oo^r<`X>c1Z?o&mPKxU7v*3!J?+g;zayPKx-xT$+UOqT${;mSBH
zE05^6jOhQ7?uG$#z9ND|v-LHVf$uN0LLT);ux;prC0~M9^R*X$z4b-hy~*HACKG)#
z6VOx@j(%s+NNuu}pKI)5D7(`7^84*wHk~0<C<~#^9achSa*GY_Yf`K_CZDw1A9;*h
zf*wHk!cTZpCkOOfgu!zf{%OZRxpBRle^d_s(dU7Kvut<cN9-+odB$y*8zUjkH~L9+
z+Z@oUA0lhwkAKaMouR9ItH>A!RXI)f)Y>wLH&@6<K*N4v*S*tYwS)|MJO5^9s_?hR
z$z&P8#OiEc?sEzwP>=&eD4JB4V-RC$4fw7#os|%ut2zjW<q|9>c}OiGgDWJj>0A4b
zOhP7kzIH0i>u7DF;KnrFQ(VsZ6M4CD$LOAnz2||VP?6=ND|toe?gax0+<;fAZgXt=
zY2&oScXMH@lf`&=9E@On5T-9)*`F6XIhcR1rbokmy?Ix>-EWn12-^7-BSNLHOv&Z1
zA!(Wm)Se-5;%Vl8cAy1b0A-%jk2H8s(1vtkul@m&Hnu-WV<WC`#y|6@vow<_OT!`U
zio3XD`@)y?Pn1V@jc=u$ZuOS^pYa2A8lndcP=CfRqCfrv0`1TL2OEs~@nXA0TT2n=
z4!5(Z_f?P4j(sh}H=BQ@bp^plSLbJq+MAlCn1cECNV8P;h~u>T4+txY+Wn9LFo4c|
ztufA^*!Z)@N#%R5#l>ki>FnQa<c_N`a?QYw{j4o#0HlFUPxHRHpmLV?jlDuf%(3CR
z4F&*p52<v^;qT-HmC=X3vuZ?Jx*L|n@aPwc656eT<5G0|M{D9npc}a>2zpo|UChMY
zBcjlKAsk_wj?U%uf2JHB|0Tfx_fs7ag7%>YtA$&C(B7LVC*atZ^$#vC?04#iUDsD4
zSBH|<fG{hOy4wTYm<FH1!^34IsTK~p-BOZ@dcNT%{pE5g;XfF^pn~c^Z(@-x$2(%f
zcKA}WvQi9-Z!CHTnS6qkO?{mD#BhayfuTU^#8=P^hZu!W*V;ML6p-m*^AGZ40M_3F
z@h!xR@bHmncOx@1*lG`*r}<boBUmzGt>@(t1uMOB`#Q#3A+6gDLJP@eHt}{yXsQj<
zi+URO^gG(sV=n(a%2{4csXhf_Mu1@CT7%HTx|k}l7xpv;+FXPIWoQ5Anc2M#DbwAo
z%T5DsLvAPkGEuqIssDfjrQ}~2`z@qacku;hIO9LF5n4v{fPDRh^DIcvO8=cLa=GIo
zNl6gZKMr3!pM8H>=R7^&ffzmDAF!B`BX8SJQ+2|8_DGc`J*s`k<gySb%7e20!5=WN
zee9<?@9Td+%lQ;_vV5+%f%-0Ey+`9c`@4x|OQ@C2{sbVHn{N7+{XaY`Y3v*SRiZge
zYil!ocDta5YX1nz<C&ctPZfouLa-Y4@UZ3}_+fCkqr*zjG0)sM<s+0#JRVRxKK8qD
zzg1%)q~J+Kz@a!~e5P-qN^Yq%YS6lYwA{C_0al<0cyFm0jR%sY3@ew1p3?MA=YMT&
zYKYovpTh?a1%*cg(^S--DW>qv5|BNMHt|G!V@EO1{{j3WhuAl9A@6jCt%`tAHF8q#
zdD<d9dX5?FFhe-wHNgL%wQGw3z@y#9%I{6x%?n++Dv+X-y@OB8F>GN40dnGw-S`&}
z^AimMWBNQvRKhHBA(m*>CzVCRaVYWaVVjJe5D(korU~uTJ!-tKOK(L1>mynIQf}~Y
zI&qEa^S~cJ$=~ElK=4(aH$XoL<Hd^a`@se67Z7(eM4CD(j1p$A(&LK__D~XfWSX2O
z7@)3ocW3LNHsJC%V-*M=To2~V8?aX*|578afZz1{bCr8``{B`*R&tcmv<-8B{9)rd
zg_aeHh6rU(H{9VTg#m~gU5;ZAJ|u)tx}bZJ4;Esrc*`7n|MC&G0KMVITAyC%`Do=C
zJ@t87wzl25Tikm-C8T-D(O_e`0qc10VEWlzE6^r<VEIVYETGok$Ay~$qzXS&B&eu+
z_C<x_HTU;Il@WC^0u6X(HTT0HqE+DQzH77KZM(2Aw&ygK1n99d02Wj0>|N4lQ)(Uc
zQNm-=vDYD2lDQl>*QNbSWJ5RSKe~#wPlW}Vvg4eNcDkZh{dV)$#B8T1<QK<XW-5HP
zQ!d2J2HpRMnW{s@5N2Bq&COvO;`{4~F5bArrh)6>en3XibRdl*p7e?GvC>43Rc!R3
zd*{j!K+t|gD6NXes!!o_Jv{(u71t)v;~!+`#<4N=mrX16E{Q&yHf?wB1{k3Nm#IZw
z6mNqF(<kUBPQ0qKq<O4V>oSKRf~*i!OC1{k-mPE&q!YU~8xkaNTPnOK9;x&42?MPX
zSBZUHtH7+3DkGSSh|4YNNaMm>@3Vyl6#x0r-_Gkntq^6AS*RXQ!Aq5h5h!YrtzhM`
z`1C?AUbG05ZR#dnLQxVPv-<Hu^jpwF78j4M%Fk2n712MYV2djK&{UV2p)po5_Qh`$
z0kq@<Z|;~K_Kd;Q;$(DM;bcdl^;F;wH=88OV1#nIHS)+HnVVC*)lchOwEGz?@@!?U
zLM1}V<_S7*f2YUuAgQ!DF2^Xr1^ard6j6PHVpLiXSK-%palglL^f%iZmD6$2G&$Qq
z?WD^scnt-W7r2!$>P=+MsmYMqYbTj&Mm90`J$WrqdutLho3G0T+0j*Lk`o87S-i^%
zRA(OW+Btub&2B69tOx5egaqyr%vY%n{qAy&Op%}if9Z14C644mja*pDv?6a)kB|P<
zH0H=P^wlJR=H<yeD%gd@?-m7LPhs)*x^9Z9_d5iL>!!>5tXoKDCChQlCU7lv<k=1%
zkkOMoz>H)YpJFr%{Kw=WvVG9Kpkk_dkJLWGnWes6zaEGyo&NOkFOj$68U!Hn+t6q-
z{^Q#mnn$>DxESEQm6^EJ)cT~|aLY5CF_9FoIJrCC_ZdTaSPrh-s=B*=B#e(xJ2|=|
z%)hYu#ICln15iN!rpFXtVHp%L10dizD~e>PORg{ByGW6s`kT3Z7N_38T@%V?CvRJ}
z?wgF<)Blwu)fDHYq1Vb<ZJW4`fjlmoRbGWu%-or-R*<_r_G<sLPHXXG;nWJq=*jdu
z4zZn3;Qc-@?xT)npDqu5ZKQ%#EKhZ=ZY`o8J~_b2&XZN$QNsWromm7_weW<jR+C&|
zsjo*u9BC<MuECNqeE7$wgEvDu@W#l@u%7BN;YK$&mlH8kV=~knLoed!<U(93sk8Pd
z#6X~**#0^%PKKB00e2qJtW2!*k?dGi^a+i71n3kl{v11;v!p6mcs`LI;`C2A&vid@
zLvmGtr6tLBlN=_Vl}3yjs1jwT`resa)=9TUeUZh^25T4K#Lw>Jv-{yCyp&J(96B=q
z2nPzhXB=P6&G|=V>^@e|#@?IQgw`mO;eaz?ro4O!wKg)ALl`;ld0@|Wg^FR#^Ubn$
z+lr2$r5_S9he=AYs0n^xMv4Na{<dgloE%|7yl$kHfuj3YW29v)v56rzV>})e4`+xA
zaI5)F`EnksH$Ztl<lt|He%2yIQGnBA#;y&IG`;n&;p4sp1<u3jmcYgWJ5HN|3KM4P
zy#p)nG;7q8q}A+j$BY%`L$lTfRYJ4mZAS=CR`E|gvPuLo)U#OqF<lY6(E7Z(c{!P6
zT6HL}kjgVL)nMj-C;;Ie;SA|u0Jyo0yy`F50|`Yr=1X117b}d0p6~j}&?bh%J-6oG
zfeRdhO@-a7k%S>(8QW}w?Qv}7s%29?5p^z=VpRQH?Fgb&8bnzk8#1X`P;eyrvG3GQ
z@Nt@9oqId8udk!a%cnSF#+OOB<_KYxZ`IHnQ`m0n<*V0F--lWS;sE>3p6?=(k=bF|
z1uRpvEYX+V;JYw;V+MA8b4TT(8<>#x_f2s*qHPVOwV=n3$9Z!h^vmgi1oaygxF^E3
zd)uFFOfRuYu7`S=t3y_R5iFU7h*s1pO7_wpvli!&PqV~WWNbHuOv>y7@xq(8-ZyXe
z$`zQMxCT{;xI-NP;xaa5!b%QG*yF#;9YADlH>Ub;x{Z)P5AhN?;^eB2+gu8AIbkVg
zs4sYGoE7S9<*k5n{q9w}GoU`BSTiJ8y(|D%FT4835o<T~xC$Qaq%nao<dDEO(Ct;;
z!cy&)cs0Y@)h_dAB}a+0LCbVu@aUV#Q6+g7>*K!42R*-$HuAi6R@*Vu`S*T;olrZD
z&r?&F6p8({PtynFQ!-w8W?B2N-!?q2Ik>P#P(|u&(*x2J?_gVq7$3#fv;nulwIV9h
z*BBZ^G)gK-8_jiw$$-1VHd1uPtio)q-9O3_$3&P-J?>9%H^Cynz_T8hw#Bni0rm&u
zADh|s)spUV5YnBvU0|;{$cv(rnO-gkw*w4kV^tWrdgl!B+v9gu7F(0<tJEL9I|8ck
z$RDrv6druL{}}Zp>iCJ*4p~i$Z@{mOxtcC)uG=<*B7-*w)mG)(CH$1%YHOv8q)Qh<
z_HM3H^R1Hxl+uGIf<&W!f%USSiBlt^qK+<MFCXI8c-B+uFtOx^r6z~(XF0<E`VaT{
zdW7v)l-yUJMJS4^0=p{Gi0J<AQMZ1#fi)>5B|Os^nt#a08-T$xL3UO0alqQH(Vy@Q
zAZHST=^3d*!G7H(AqH{@f1AQB$<Ci@O?ECy%c#WH1L+=V<5K6Csx<V><fwBkg6q}b
z#m!&7BPtzgYa9y3+>k-4TEcI!#62+Y`h7#x<0(8xQ^_`QzVV^z;#NEX6}(#ON*`A9
zJ*%}UF6SAC>Uv1RwBnr>(~HX$weU1x#6WEJ<Ed{Zu4g^8J{xWOl-{lz4i3kS5ZT|6
z6QZ`4a{oHN3v=7lg#fBu-TEZ>vB)@t&QjU+K#aw@zh7!>xRtf?%D`VpHJt@sTnLYr
zZSZk24le5!ZVt`2CNu|Gl%L8RS<4;CJ|1I*`64a+T3O?uvu#}ei%8d^UCSW1@3<~E
z#5uNkH*AofD@u&K1YH3GjF+2d57wyj!yjGC*!gzISJW4`IBe&5z46h-27voY0E^7*
zF0B4;*Ghh{)S+u>oGo?htzL`vefJhff8+gj{i#-YzSqct_HPdjc~#wDzt^J#@~BFs
z$A55*wFq&;2sDc~G&bX?`$p=TZX;lgtAWs6cO5pj=adNd=T533OvwEO{YGMEWzC@8
zQwdrI{KkQRW+u@ja8Kwo(bY2}d=3rd(6!unLVV*XKf7XnZ1nJodwXsdM*)|vQZ6qj
z-NcR@thwHi*J~WhAOR$a9l5UwtM(HXP6A)jXwLW+atNbeMNs6*0LA;Rp8IPx%+LS3
z<26pjIe6h7>}@qqnx2f$QFu|h`0x5SrYyAvNlHq9dPkd-#^O59+6>Q8v{D-R??e9v
z8<nnQ)hthRS;hXULRw&T+q~9v@?0sc)ONHejw#u6vN=ecm-A+s%Krp2gIZ<l)5l8Q
zsi-H`W2*nNSg!0L?+MOR;n6p}TAVH(g;bLM7VlI}OVZN=bmxPIt{=VCb-nshIHM~o
zt619i-GU=Me0E~oiJu-Ye(RR~{da4+QAcO2tQgW_75ifF81?+pSUUSr0>Iv`F!`4K
z)7+1712_IFK-IgGAF!e2y|LJX2~>`Nrx#w|2^8&aNT9A9{B{VE35-*TEm=;NL~!>3
z34Q>Kd?{t>WWLXqch%Bvk$pqVSR@~^W64==SCKw8vS_8^(yh!8nYr=z^s%oO2XHQI
z|BVtY{B(m{W=#UJWNLFba|hN}Ts)*ebJcH3H1?RmMC4texTe8|xzo^N^niDx7Du@u
zix?Gk_Oh2M9b$xZb>3X%qYThT1TDT9hp{ncM@4h^O72oiu;1kn7=D(v?Y8RRpwauL
zu@V(=7gP1eJ7atUTfDwGea>_!Q7w;b3Ec>;KYSE|^DnN=GFo%55zd=(h~Yqg#h4O8
z`P{~EKBcWA>iP@b%q{?j=CuQzcY8iw=Vi`AEctt^7>EYAdvP|Xx9f60!q%x%lf8u6
zV%6BG+ee4`c~KKT{X=$C89BQ4!ZOnUZg*9&92a;%Ex)*$N9wMWLj_O%^pfT&iM!|#
zNz9;*Z@7j~O*0)K!6kfd!oXOT^4GKMAza_Sg-_gsCVTt;-mR_ZU_zdox&o@{3wiFw
z=OKrTqE*1o*1_r&p^}nz+?(KEZak#D-=o4->b{{><j+Xs4^OX-9paYP32R7+scGfD
z)<2OS?fS}>fN6;G`+VZF_*I;|Ix;Fi9;fH@W=3-?b9N6nR<_)}|0HuE&3{ExC+DMV
znS1(`R@w5Jt1gty>ks$FE0}!meXTLHiNDr}u(|iucerGL??w+FqWK9YHqp3F+uri_
zCQ`j>>Ei6h<nEk01E2<(G*iBJ&rS)d1RL&<Zke$RrzJ6Im;CkB%%%lB$7()KF1R~#
zh<){qWJ8>RTjG`3^nUbgR!15nH1ivBK(9fd;_Tdz8&j`d(Tph~Z|+wrnnSF4H-ND)
zZthQ(l6J+Sv={(3%L5zJYtS;k)Q2<BLgB%4Bi+uJeEzgC8E)>{$*oF@ED1!-VW4eW
zm}{M?0=A~ghF7&j5AT-#g!f^IQ^+;i=Hj9r+@rN$<aRcZFCEaT15-B;Olc;lek${F
z*)p3#*7~A4QI{4i>eAvV+O}VvolE0#`b5sM_+Dx0b+{`(=a9YhQVCk3YBgj)kSm)D
z&E+zs+Eyo8WwySPc&9|&t3Su(*W{U_#xsR8Tub$=>O)CZq_6<W4XfOm-{4B2aE)lU
z+?D1_^xPIbwM-Ir+-YXUMZFsQR`-aCTT96_j&sM`0&1ZGc<IZvwU*Kb*1^-Jv<$#s
zBs{t!7qIqj!&l0iov!jVO}QN9;{NEx(l?5h9|_UN?Kx@c<>>jp3Rq{yFnWCP&Jz}z
z+BkQV!=tICBZc!H7(d0mjCu9Hz3oVM9P#=eW%pO>{Aamlz{c5$TTV2A|8uDSE7{t(
zi^(LmZ8&=ox^v}cJvv=21s>gvDwe4L3JSaF>+CP(F_P=G8^f&PI@8&Tr?0|Z+WAxl
z3)8Zs&zX)A$HE3F;o4PVmZD}+zJsIbXMT;lcowE8$zR*I(mSpAyr;rKc1VB=-<z&M
z!CK+pB%!gOI>+Mciw<mx8@i8xBBC=I0wBVCG<w#oJ!J`0ovVLyV?UP$U#Z!|YCGM8
z8gDNDlKmq;dY|2Ae%C9wlk7i934k51OqURs?GINzpjmsc8l89OeY^LTmntra+6y%)
zm_-bG$>%|LBF!jIzow6^Cjg$Z>icQD7p1*+&A^{_aDSSKd?y14L1;JXOxAsv|3T>e
z^`(5QkVelt-9q-&gUP&|NP0(!@aRS7XT0q$Q7$$IIx)h|fu&z*9PuT~zL3@kz(H#S
z*p{oe;k6sz_{;|K?q`)??z4cU8ru`TC^b(tX*|#@up#oqS_^lsZysBv=-F(|t|m|d
z9P?T63p44-6>aYDz)CmASjMZdF-93l6kKD`plD)7ZL4d335%H6crHPsl~u0?^-6L0
zwpyx;NgM*2;k$kZg&K(eMHXldF$jIa8uaBFt*2$MCO~Itr<YdKxYhwG4=!Q{b;*ws
zqkgAU1Uyjh6&<#DweuBd(<*!O;CwM?b<w;#I$dd$*IIxB%?H%w%`H%PUz3s5b}_Yn
zKGqs>Z;s2Z!K#k&1BezZgnUmHiP2V`rK-UDQX5d4MavSEaJ~#PdoFhS!~N!HD~a<o
zjEv^E5^P_%=EMzn(+YJXm~ArU_n%@V#u=nekNMKfDzf@=bO-9o&E)a+NrTvR>$V9V
zg0yo(n=}JbuB2T&i0~l7M1<`|Yrb|w?+Pgcjr#5x>$`@-vmK*#RJjcW^0wc(+<Z@j
zg*2J3!NCRX+xu|>kGMckxVE$S$l5Tl2{;+B%1nI|-HH(o^1FI<uU|Hcr)bmvGx*?F
zJsR@?HeqxoPuy_{CuF~e?CS?@_ZJD;4_6o7!ip}~Pf_lr4iJ51ly067-TMKbkK{A_
z5_SGvc=UTTQwi2BBzDq4oFebP$p5E*gnQ3!7=5Rfxyr*Q<2c=mUEy?EF~#zheYKT0
zuj=h8!@J>;-!uw_KZ>5{$GQumN~KU~VcK=kR=2hGG0oBVZc@AV39)=Lv)MDsexAEu
zdZmmV&8Z_KAFwlmn;pZG<L&p*FLd{d9-xOJ(v#F+TQh^nl8Bu@Bz^iWH$wrj1OcRZ
z)}rMY0HcWQ4`2`Bp{DGI$Rf0*qXfEjig$mn!X$rrijSot1enJz){LwfI(4}F8RGQL
zY;ORGaT9+Ka`%oZm$O3b4|n;ryYP8<urpBVk61jCB;9>bOLJ!$WWyOj?&GXCn0o>p
zbyvFScCcUU((aN$;Mn7ky?(acKYc!dv2yvIB71&Gw7vigkHD4->%o`=8u)!c8ob>(
zouUY6F-&?7Zh#i*@nZMA-r0=j++Y=J20LxO7cgyWOP|$dc{aw;+#5De7TF2KE$$gI
z018l}`yF{gE5M8IG)3)=?U&-5N&1D(y_d|TCl)#E(AePZt*pORX|&>BX4_=|c=O$Q
zu+pvlUTl*lT9{w`H+Aqct^+(9F)j-J;X~W$Pm6_o3Qr$)2h;{=&n1CdBWduN#oLC5
zGg^Q7H9T}GIhx-OU4+fu4%99F{=}A7l@zKTL2x%h>f1~bW4h4GZKt#x4jRK5eWqoh
z`+L>9ON$DBi)y8I6YDeurNW!LXh;uOvN>t9IsaM{(2rFME6!;X7b}PE!SWvVqRwIu
zN@Pu+7Yi|PXyiMF=xvd1>fZaPM#Hkr?6SRf(+=0|N3#K2m2T8LR+ruj=j0#qwimI|
zl-sU|U#MRf%B1y!0etW09a?A9h(9u4dedpGr#s|N!IJI?vT`EwSY^11dUrmXm~m5&
zu9BR;fAEjDD`e)<Rg=gOxf2ik@*J6eY{c8nc;xy7nszB8O=CDGt{ysTZd-B16P%Y@
zX(v&zM#iBr@JIUyOx>LMC3lLs;^zKnb%`EtyIDdfPf6_uyDFPa-k;Vt*_yH=WhX)2
zt!c5cDX-frG0i&%#KYTj>Rf-A=)u2Cw4)M{RCp+Uuh|#1!X!Rzr;C3J9{T?2*M$Q|
zP?0NsC#<r@C|ly`OyLWluzAkk?w2mtdqP)P^^2JUYjWKQMm6Jkk*RvY;tYU;OP`>;
zse<`zcU2BxO7lPH;MRl|xo5ayD?nn7__nQb>H2J56}4F=p*elf|BX`26+zR>#1Svt
zjAQ%sSKs3646TF6=YbB9DORYvY9Gc$%m0`cfq$uY<(B<PDfMCO@ZqVcGz9U*)p53r
zck!_DIvlXR-&kW)N4aqqz=4szeQ@c`oZz{G*+b_}Ety&zfz~f^(I3U91ZlGNLys8g
z(u@xqXu2s@>;67|M{V+1NvLsA%W6RYoJpdrq0?12M5{`y5w0K<y^6*8`CUDQOcz;S
zA0zht&c@3mdX9cyP8_{g@~L)WWpQQnk&u1hDaEzIcmJ(j<JFcTVj6SDHr)dw!r`?S
z3<qGWdA=LXUdGN4Yt=b3ZSME2ZY=&^6Cj<DK21`}t5(^rv_?-*)m0_6R9Slw>|Lx{
zAdG9b+x}2dkWIqPBK|>aE-e1O&1<BgTB}H6t@&|qrwJv-ytSWZ;=kyXO(-(<tFVfR
zsrfyKg+6K{f!<~;)H0%sdvs+uWpYn&zJ>^0t$#9ALkxQ*Q5=_p=2=VHFmhS7VL7;2
zpCNIQW*Ay)#v+ed#Hy&Lj1xP?2l@HTtRNu;aW5aJEkXUY+#Qu26r~)&#$ATZ_pi@b
z%I5zz$i!0GqFMc+fv~31QwL(1y|fGut?=yU+Ouo>!sG!jpLU9t7@jQuD|DBeU4-Ja
zf7^=rxE~sw2}qzU%YiKQW;t`UgHI#vmn3;YX_R&uNLy>CD|vC`9RI&t{7(D$30l#W
z5cDEu^<^-;_ygpGX3A|tMBmHfbdS{kR`Ttviyv+NDn;8E?k7nhMg=<`dgw)ze~5hK
z4{1|U^ebl{xmXg&)np=c@<$4gGF+_>Du3=LZS7WvW?Ig}>vYOHM|{%Z;)*Zs>uJBS
zC<9QE74czeUFfd7P>Rf#sW7VmksK%7de2&y(!alu{0VJRhkZ5qIY-M&WE#3joDX3c
zgmEUwY~L*p^)ZYHo94Gx5<xBK)|9@ta5#LbZGaFH;VWFa?&d8RCVdGCt5+Ode&6*C
zEIv$fwRUJv0~HHxFGuE4_eEBf?h9@=0`83K#cb%)J+GmKxW`ho7pNx`nKQO*nL&S}
O7)>?3hvh0yU;Qs$sztE?

literal 0
HcmV?d00001

diff --git a/Documentation/WritingReST/Reference/Menus/IncludingFiles.rst b/Documentation/WritingReST/Reference/Menus/IncludingFiles.rst
index 50562085..66945ab4 100644
--- a/Documentation/WritingReST/Reference/Menus/IncludingFiles.rst
+++ b/Documentation/WritingReST/Reference/Menus/IncludingFiles.rst
@@ -8,62 +8,124 @@
 Including files
 ===============
 
+Includes can be used for two use cases in the documentation: Repeating text
+snippets used in several places or breaking up long pages into easier to edit
+subparts.
 
-*Recapitulation:* Each rst- or md-file will result in a url of its own. At parsing level
-these files are processed independently. Toctree directives are controlling the
-menu hierarchy of the contents. For each file intermediate results are stored
-and each file will be processed during build.
+Some documentation projects have the same snippet of text appear in several
+places. This text can be maintained once and included in many places.
 
-Some documentation projects have the same snippet of text appear in several places.
-In this case it may make sense to *include* text snippets. The `..  include::`
-directive does this. What you need to know about *including* files:
+In this case it may make sense to *include* text snippets. The `..  include:: someFile.rst.txt`
+directive does this.
 
+Files to be included **cannot** lie outside the :path:`Documentation` folder.
+They **may not** end on `.rst`. By convention they **should** end on `.rst.txt`.
 
-..  _how-to-document-including-files-advantages:
+..  contents::
+    :caption: Table of contents
 
-Advantages
-==========
-#.  Includes are performed on a textual basis and therefore
-    processed in a very fast manner when the parent file is parsed.
+..  _including-files-example-simple:
 
-#.  Includes do not lead to intermediate results that need to be resolved during build.
+Example of a simple include:
+============================
 
+Include the same text asking for contributions in all Events that do not
+have an example yet:
 
-..  _how-to-document-including-files-disadvantages:
+..  code-block:: rst
+    :caption: Documentation/Events/Event1.rst
 
-Disadvantages
-=============
-#.  Since includes are treated as if the text had been written exactly
-    where the include is done the text needs to fit with respect to
-    the section levels.
+    Example
+    =======
 
-#.  You cannot see the source of included text when clicking on "Show source of the page".
+    ..  include:: /_includes/EventsContributeNote.rst.txt
 
-#.  The "Edit on GitHub" button cannot take you directly to the editing of included files.
-    It still can be done but needs much more knowledge about the GitHub interface.
 
-#.  When Sphinx reports warnings and errors the exact text location can be much harder to spot.
+..  code-block:: rst
+    :caption: Documentation/Events/SomeOtherEvent.rst
 
+    Example
+    =======
 
-..  _how-to-document-including-files-recommendations:
+    ..  include:: /_includes/EventsContributeNote.rst.txt
 
-Recommendations
-===============
+The file to be included:
+
+..  code-block:: rst
+    :caption: Documentation/_includes/EventsContributeNote.rst.txt
+
+    ..  note::
+        Currently, we do not have an example for this event. If you can provide a
+        useful one, please open an issue ...
+
+These rst definitions will be included in all places the include is used as if
+they had been written directly into the rst file. All markup is respected.
+
+
+..  _including-files-example-advanced:
+
+Example: Break up a large file into manageable pieces
+=====================================================
+
+In places like the TSconfig reference or TCA reference it is helpful to display
+all properties of an element on one page. However this gives the contributors
+very large rst files to maintain. Such files can be broken into pieces that
+contain only the definition and maybe example of one parameter each.
+
+..  code-block:: rst
+    :caption: Documentation/ColumnsConfig/Type/Category/Index.rst
+
+    Properties of the TCA column type `category`
+    ============================================
+
+    ..  confval-menu::
+        :display: table
+        :type:
+        :Scope:
 
-..  attention::
+        ..  include:: _Properties/_Default.rst.txt
+            :show-buttons:
 
-    Includes can easily cause trouble. Think well before using them.
+        ..  include:: _Properties/_ExclusiveKeys.rst.txt
+            :show-buttons:
 
-..  important::
+        ..  include:: _Properties/_ForeignTable.rst.txt
+            :show-buttons:
 
-    Do not use the file endings :file:`.rst` or :file:`.md` for include files
-    to prevent Sphinx from treating them as individual source files! In case
-    you have many include files this would lead to many warnings and slow down
-    the build process considerably. Use :file:`*.rst.txt`.
-    The ending :file:`.rst.txt` can be used in PhpStorm and :file:`.editorconfig`
-    to define a reST file type.
+Each include file in turn contains the complete data for one property, for
+example:
+
+..  code-block:: rst
+    :caption: Documentation/ColumnsConfig/Type/Category/_Properties/_ExclusiveKeys.rst.txt
+
+    ..  _columns-category-properties-exclusivekeys:
+
+    ..  confval:: exclusiveKeys
+        :name: category-exclusiveKeys
+        :type: string (list of)
+
+        List of keys that exclude any other keys ...
+
+The option `:show-buttons:` display a special "Edit on GitHub" button only for
+the section contained within include:
+
+..  figure:: /Images/include-with-button.png
+
+    The edit on GitHub button of an included section
+
+
+..  _include-properties:
+
+Properties
+==========
 
-..  warning::
+..  confval-menu::
+    :display: table
+    :type:
+    :Scope:
 
-    You cannot include files from outside the :file:`Documentation/` folder.
+    ..  include:: _Include/_Content.rst.txt
+        :show-buttons:
 
+    ..  include:: _Include/_ShowButtons.rst.txt
+        :show-buttons:
diff --git a/Documentation/WritingReST/Reference/Menus/_Include/_Content.rst.txt b/Documentation/WritingReST/Reference/Menus/_Include/_Content.rst.txt
new file mode 100644
index 00000000..fffab6ac
--- /dev/null
+++ b/Documentation/WritingReST/Reference/Menus/_Include/_Content.rst.txt
@@ -0,0 +1,14 @@
+..  confval:: [content]
+    :name: directive-include-content
+    :type: string, local file path, relative or absolute
+
+    Path to the file to be included. Can be relative or absolute.
+
+    ..  code-block:: rst
+
+        ..  include:: /some/absolute/path/_includes/_SomeFile.rst.txt
+
+        ..  include:: ../_includes/_SomeFile.rst.txt
+
+    The path is calculated starting from the :path:`Documentation` directory.
+    It is not possible to include files from different locations in an extension.
diff --git a/Documentation/WritingReST/Reference/Menus/_Include/_ShowButtons.rst.txt b/Documentation/WritingReST/Reference/Menus/_Include/_ShowButtons.rst.txt
new file mode 100644
index 00000000..b033a607
--- /dev/null
+++ b/Documentation/WritingReST/Reference/Menus/_Include/_ShowButtons.rst.txt
@@ -0,0 +1,8 @@
+..  confval:: :show-buttons:
+    :name: directive-include-show-buttons
+    :type: string, local file path, relative or absolute
+
+    If set an edit on GitHub Button is displayed if the
+    :ref:`edit-on-github workflow <settings-guides-github-workflow>` is enabled
+    in the :ref:`guides.xml <guides-xml>`. In future other buttons might be
+    displayed if configured in the guides.xml.