Ev-w*kqULpaAHXjyQ+0k>iagK=N*sK8;`~sPjk`0
zkCa*E1c3c-SDl_4HB)l*eUw`dhmOm`f^k~c-uk6R@32P-3n8uQc>3Tm5R*JE4nKHO
z_Panm#FiNAf5GxinVUs&C(l?u+*e=@Zu7dP2hw-_r?((<=nF0oo
zlS-z8;N-F|hmb56^br8)i1%J2VgQw5WEnBNdY2SLE9TAGUZk&-I%tHB1J2ZE9z}8A
z3>_!yFN3~an1Kvh#M1{&wf#HF2{qP(DTVz;UJ-@vdgZZYMQ9_-={Qr->tvTO54{H{
z0LlrB3Fk%MifCS%ZbP1T(y>t;C$%4fp8k;K=`TeXzF-QIyqt$;^zN^1EWe4pllfjr
zGn=K^vGw6|ng&wn2zur{GLDWDb@`=V}qlus^z0!XfFObVMSpf;6(|A+<~jmI96D4sVi
zXC;5qC&KE?MhA}!>FR-v~yXQ-mGIJQ_P54FG1es7A4!h^NSGWb<-BEraeOF8PSIGd36&Njo@%JHj
zB`|FHbRD86Hy=&3U1r|@Y4$sA24W^POU5B_4oFF-(u#`nA8SvRae4C}SJa!YUQc;v
zKgGve+HHS;C=P^~nbrk9S
zJ`e`Eu6p7i@~y_(%$S%vDj1
zjOu+`QQg5muK|xJ5#5Yv&jcVREMp<$vMWJMTYg{gu#6qb_}4XIF4@zzh+)@nNs2(=
znN1Ckw-(LkD`Xl(SkJD~-$*J#K7RI=j68Y+g+{75ZP9~slAQv^ejt1l!7R_FNIlVY
zMb#*-K_|J-Ly~O~!$2TihCxPoI1V#f5O3*<45D~m!OVii`{j||v8sQeE}5GblY0c+
zb2~Ipc*;JTIu_RQ
z>XUfx_+s`w(RkhfTb
zdw;!urw3`+Amen9TaeQC(MXv>S0eD#3-#Q7-?DKU&d+#URaK0*Xmxu##t8p|5|Cd3A9V)@CD2k#o2YsQ<&`o4ZXoT*b
zr4tg%>{t&4n+LH{$@oxs;H=`8XiO9Z$I@ezS&?k;K5-OXG+WIoY#4CJ9*>zap388U
zP~1d@ENBY~j9nK=>BkD-^l^u$@UDFfJC_3$#ZyD3|B(G&)eY4AQ9Z?a!eCju5mC#v
zzTg+TyVRl9hK&ABR+ATbdhm+>gNGIEYudnNVpFj!bA?AiL<(-WBQcXSVEYj>2~keh
zycAjsVvb7zA^BoHS
zD(vU0T2}*#17T`qR*wx|A50b;>d}C&jP{-&^NewcuFBV&B{SaD7|6MpGB?Q
z6+PmZSkGKFaQW7kwmJ+Bjr&(sIpl_P-4=W3!<OTvWVLQmw0kSf
zucj`yyakiDgZ#kT{G2axmp|9~h&fK0B@g>t#qz9t`tZKBt!NE{Qc-%RHs=9ra%^wR
z*<9d90dDVi|n>iITuFEM|Y$^(+b|?Q76b(p0p&
z1AJaB`pb?-b`J;F+SJfh@*uW#HJTGO<-F#*xl@oX=WK9$H)_x^eciSj?2emaoa-?|
zlD58G8B&URlB@+v$Z1QZ}@U4dv*r)T4+B)Egq;$_$sUl82jWfSAaq)
zoc;Q=zo6Xp7vbQl-cqqB8X(Y|^sIJ3uzRPB^l^EAwP;D7dzu%>u9A^a`8kEzdkJ);
zEtccYF2-qfX_|NlP}eiZK<&^Ap(|4K1gZjGAN^me*Qc^oKIWZi)qfc)VSA!BlT+#u
zMUJ}O;lWHrfXADEaLxGg6RJI!8w~XNuAlJSz9ue_1;C4(eJZzGN2vGiKUX{!o68b8
zM!o!nYf0XXW@0H7N7g}|oR^>9SMhWDLNr1qM_}l@b
zZ7Km|d;q#k1DZmC93(=g7Yu=Hq4O`XZ^!~dhZ@i5;&-41rK
z^iP;JBUkPSIZ%eY{&AE8YZ@vDJzuxUpOa1tQd9Y2k|unS>!N|mdT6X+*PaQ?iWV{C
z_ILa;%v_IT=_aZPdfZ&n0%FtCPgy^WR=)L#5_e#3A>Phk+&I!T7bgr+;6S8NmacFs
z1Y4nGTL`jfYMq?QdW3C`16v=5pn8EX3MR9#~P{kSe(D8xOS`5oS`ZQ`RGd2pN)j%B?DU1X1m6e$YRGfHfX
zG6Cy@jjaL6dO3;i$?k8(mn77mLPNuT*=gc2bF88>)Tdgn082ET2St}Wn{khYf
zfON$i{`3AT{aZT;itAfmdKm8PFA(r;C)hW`1?SP-rF;S6n|>(3zN@H{J_-3=o;76W
z8F_45ao~N8g-9%_P2imolB}5RhHc6>3AEF4@wWT9uxSgY2@s{;7mbVDl)+ip+tyCA
z3{Sw4?LSCA`dQt1zFyQnR6u*VO~vdfV=Mc6iG~as4-32NBSl`*gR$tba+>i&d(TPs
zM%y~$S5*~SM&7#D72_ORc=;#$ELq@gioQ-&HOdIm3@QSEaMA5+ph%MYcl#>mw4EU<
z43ju=B)q3#B4;^)jDQxSU*V)=an$Cgo?I+D&}kdbuCQiJ+e+Q0!N19cYZg>4j*0$-
z*LhQEUn%qE@ETdbGmaA&P{`Zy4k`2vnJ~&PB#iI
zUAo-5GXycdW7IUFO(GrsU7tL@w#u9y7hn=9F0`VNQhUYl$N`PrN=8zFp)CW4#4~%1
zEZ?8xd4HsuamlcJ$+K#@XIU>5ijru+9TrVAUOD85C&}U`Gf@d?hV_knG3&-lup6&_
zm1~nT-Ckd8FM4j@xF(fs?3Y1a1L8)dXFQPe9?WW_rP`>XZBlVWx=_7gLr%ORHkAmt
zun6lP!^zi>nu}FJW0}`d0`_vajyxCmGxeXtlv*TxBLDMbHGcScK~G;pqsk`5&`
z(>fT@=kdd_mZvNWN5;@zxxr0Yn~jGK#yT$AcQ%y(<%x0%K^gOp13GHe$LS
z{w(vAGN{etZmAHks-i$6wJhyn2cyekhdc&@IdTCaa^F>mRN!N@s}0xoGY>SBt%x@M
z9sMW8klXIp=g(w)+kF+tupzfnNIyf}`=KEUC%kCl@1btmqpDk($tY;ROxICO1HQvp
zQCgO$M#JFp9#oCV|Geq66-hI12A9v(c_{C?Z2pA{3-&(nQ0TBA!Kzsq9z<$DI-MVF
z_%NOF@vJG{T?2Re4fLK>s>
z{HO=hWEA3?jHc4=js|KTYff7vLc<%&2e);jar_PC!a42=UoNiE3_82h#IXj)9l1&7
zYj2=*8eO|%;sVPZYgpWbOQXnji1B*TBqeMoMvYWvKI1h!wi31ILB_aDg4?3Z3n!h~
zw%7Di`v%81_lIBzP4c6!U#dg06p#5&8BafP0&|Ig5{yJxxTIbOjDFQ{Im=?XXeR_R
zw&eZ6zyL`iSyF`Y+J~|i-huva_Vh?7oe%?B6b9n_m@59^md~lWLp?RoidvWE-Go
zZO{8j;5gT6SBKdykiKk}sXR=>9Pg%s6R&vQfbAE41B$_2Iwp#7oT?iMG^l2F{T&kA
z5N}1xq9bU&wtpsF9`F|B+hi!IeKs_TZ{Aml29~t%^W;P6ZO6WVE5RI(nF!!2b$C`P
z5x;JT4cCA^0&`bB4s{*BPc`&!0AvQgM4V^#LJk%cYLA6
zhHX)bD!ENdj0iwvE?7ZzmUO1|>2kuot9}URrER&L%NC(kPn<)6lj7Qf$u<4{4Lthp
zctYr%H%2YdL5#hRX$-p}x-9}E0{3*>T%Ya=?#;7f#nikZr$B#2xP@B6B-BxI^Rr0A
zX>bO3$)6a4`63=!_mNk-5I5HH+4g0CM1PZdbYi6;twZ|s=U)Blqb)cX&c$%~ZEFm#
zT|K@ioXE15jzSb1oSVzS3XGm~$f=dgvgT6e$xCQF?iLBq71&K-0pLfAXL2HP%uuYG
zfs*GIwuMl8JI$ZYWJuhiWR(X9CkJ@uA;VyEA{63DwpH><%!wtr#s+Z%ybzS)CKfke
zvs_ZBoSZ#|)0E?l^e&Z*--jYwYwH4v_;*1ZjQ)fV_z_zAjRQ~L>c{JEEZNG#eFdA&480k==k3Bu|T4mucN%3l2bbB
zX^EZU$n+}floN;zYY;(U7lHtW*u+UC!;+E3(A3%>BfvLxI6mCq5m4*jk2xUWQN$Mw
zY={KVwwwEV?ZIDYM5E=v*nW2z4d+;94uqZd)3_s5TE0bLL&DhoXxNFQ*QuI$CBHKmNL2GA
ztQ|%wHcKK)f~a5D0mYlD^1-#UuLx`_2fl2ck}m2Pdhi8K2AH)4-Q
zr{+4m48fPAy4kK9^mQ@?+i)6$Ro)~Sq11C&EUs82Lbor3Y;t^^B@YZl)kJV8d9vP7
zR4je)tiN)0^b4{VuYwO`Z|t8>mhB{$r*pK-$pO#gDvOU6^!x&GZ>GypJfy!_bWT^=
z&*5GIrVQz6a>fYNJlH*}Z|QY+ix^k5)c;={=NZ)Gw(nuu#(<%>gdzbHL_s?cT}2!fFK|pDN>a#5?bgj6hk|>_qpfJoiq2-`)$oTv(~)t
zn*ZDUU9rVeKp*xfk=t-0Q(}raL3I3T2Rp&pd2Qhfd1F=sdp4%{N$+k`_`5v=Qg$rR
z(aPucXJBGo?3-%J+N1L94Bv=bmY~-QPLv;%D^O3xABPGbT$DhhyvhH3e|rT(XJQMH
zevFNDUUXEPILm}-YD-K$A#zbJdJCusSQ+V->uGb;Z~G-|0EHs5i^=a4D~H=aM%6%R
zopPX?KdiG`<&Wjajnzd}FJDVgO!06#xC}N2Qqd2^)+E1wp$77VXQ&%hh`9d}ne8{N
zGQ@dF$hh+MMOY(heoPIIN&vkM%O3D;=SVX2feR%%CDtQ5AY|ko@_=x_eNF3Ac}|aU
zZ7CkJ*O7|oG|FhL$_$^?sSru?YVqn1r+9L#1g4>V=50Hhf&aHK*Ee)#qD(oAKs!Hg
zpuurUhU6rEywq2)US7;Qorm{_iO+_NfwXzFs=$cIF7n+#`$_?k)=v{rdai862=Dvd
z<7pH=h%m+A?oFt5~*^cn+u^CtvxrTaGf$q!qy}m9J6-!`%ro@wcUR?RqJ1
zTqHeL!o-ss=AJ+QMt%GBb$)$(EUq+xN0y*W(DdlnQ-O*ed5dsuMyef&U1)V9Gl(wMS|Z-%tioYr$ZYa^MbBOf#w`$%=WumD_1AA38eu)pR;A``8x~0mAuNRmrbiC1aK1~)O&?ZaMO}Gdl(-uQ3*Q~Hvv})i
z>*HmArw1Y39HS45Ss0$ib7N!ORgmkBvcRcxIR^2u@+XN8
zWSdc`6Q5S3Jh+a&v3B!~95H~!3cC|ue1>o(Lf1tG{AFW5M~?WITbAGTqAv4X@R>kQ
zR6*F#T%D&XC;S&btjB~7yZqXFaY=1%k&xTpSTdW|O}>^#kru%SxmefS^AszSLLTO|
z6IW!Z7xiKz_|d{rb|k~XEhd@oY{Zi)jXo)B_hOBpm|!IUAId(5Sisg?c0`>aIJf>r
zQ)>Yu`ZF%no(o-+=-wIW8;eXbL9>v;r
zEZ*`i$W?8DD-5SmuNq^Y5voStwmc|BvXUNlzn3vq`E(>%6p%^+i@4EQw?3K2CU<4M5?t5ThZujL4;?Q}*Sbd(vFJ=7PL|
z?>}6GKN#j%dzY`$rGM7V<)NPCF17>?hz;cb!N0KK6cEx_OgsAViKF`G6O|oRh}@8_
zkz~JHEuf5Tv!OafjpMXEAueZTd}~QBh-Irhz=p
zQN4u0JBp7rKOTZ-ZFda>*2AdzJ_JAmdjedv<5`$T^H80Q)_=n8G<>CBzGd$0CV8uu
zW@4IVG?+DpMWqdSV1IL;9t1*miEvvn0;>TGVU8kZLfshMhHKhKAijN}dy)D>%Dr!l
zcZ{Nr14eie4chEdpU6RL+335KU@w{`qaPUMLkIqml2ACx4?0MgHJsJiNn)-FJbb$W
z=E>nSjLqc5XubU98!gSFrMwH5k(m-=vcg2!T)LQKTH__VF6fw-9NTM_@V2j24L~gj
zfI}>4*J*)%>ga3k+Kk)en8?_co2gAvJ50GJ@Bo|A92)ZJ<|Da7VZ%2n^fa^q6kTG~
zcmXKlm6ah5$lEm!pi~F!k8fJ_BG*_cT|!M?*43F`Ps>1;(rLGDk%!SoI=Dsbo~J~{
z$%{IUvn;cZ-VHpS@ky|5%Jz9x8!o^QEw1jaD!asGCh71HCP#ODuRbtT+YU-^%-M-)
zUN+Qd)}1L3z+eoa~=RGdEYFlrvXL?5%_M7l?#ES_4Mh>6iM-7N7{?A_5|gb=~!
zMp=a|6VcoYL3{CL1(?9$8f8OX?)HX=s`mo<)*mjP>k`%gsD~bI{!u4g0vEdjmz
zb#9L{NTkW9n*UNqXMC?YVuI_`ORg_Xa~a7Ask-qGrCWJNymZ~*Z$27JwCXfB7`V58
zQq9cYY5HUBtwaqNIjuJ!4NdwU`1NZ1aW8us=~wvU$Zy)APE%IhyR$=d&yJ%vW$Gb4
zH-i>PX|Kt^gz@-5UXembVVIWC1=O=JOD3UGfb`wAicjno0~h*pVauj48_llKLO@s5
z%b(d{XWJ~7w|6>76-NObE(^SlJD?QjUyh9dV{Do)ATZ7J2d{pluhX>aL(N`~=i!V9
znuq-jj{eF^o*Vs?aY4hoefEZyQZ|20FRVeMT3J}A5cS1&;g82@Gh5lNkxeUdL|wd@
zLr-ktde22%!O~kIl>=vNu+%vv5!<8O=@iAsLDDmI#fJDlaj|=DD^KGtD{IT{hWSp=
zs0NdKCn-p#v#84MS}`4KnOO6xsRqgesaYm{007`w0yyt+rCV5XaiP{`?Qj&CM?#NWB+BsM9?%Z><
z+;Y87oL5YSnVvX)Syz_%O$@)$-XCn?7-kp3t8Zx~rstm$RwGxpo&}djN945)sB2g5
z;@;bIPTef$Evb4?;Wr(RvHCZNmBr-h4jdwY>yqCZMtqvud(`tDAGNfL@+54!#-&AGt;c5H=i^a9}SKH>C!wJ7(
z2PsnXmllTYP0lR7*?G77AvW-AdmaeG77>4k>3kz_~b!Jyl$u6Go5c8h#^
z#Y^taDC&V^h_u8r+Fr<-<t`z1nJ)sloY4Dnt&3bclbiM2
zN8)(?qc^B+-Nox{JnOdggtGf{qx3^P;MB3FElHK(o+SXeCq#86=p?~&{qhSi127v;
zqS~8|B7f0u66KPBKPIFA9{SOOt>F!9pVJ)e$aH)&Cy$c`fxnR)
zFG$|J*$zsj#wdH3;#upLklnI;2&EYX-k^
zbc8+|echN4Wr}605ddx}r#=P2Y3TFwB*)B1Vqlw{#u{PEVskl8-6=uy@xc$tbS$SG
zf*B&NMZ0p=K8a&rEsL}o&ZLMshA2src$i8v()j#k*l3lU7MSxbH8FB)e|dYxZt5{~
z&pQ1#EhUTT9W7R3_yekO=60u>@rn>npI7__Tu6Pn~`dvh;;Lsw+t9J4CSa`!uDfJM-b84l8`WlOH-VV!I=;
z3wgYvMXR3sq>=nQ*gQ@quh3&`o-#o0j~k@sNbb_!j#cR8FV_UW*~0R&RHYG8Z~NM`
zym$$k#4=t7@-_p#KT5*quiX8VMVUr>4@rQbahxyR^V8EoL=4i
zc*RG=
z_(2Gb2uow5
zWku6I#z?{yu&mUeuDjcVmc*5grWD~4)?dnk>(5)9zqQ>Y73Y2^HI{z$1qzmayH#?N
zELka7`ArL0i=LHP$Co@b;7{Irsmrvo=g
z18OfmI(WSk_8xoprTtN?Fv`%`L7LYQ9qB@O`I**Tlbx4qtMxR%WC+`J9fXv=g92h<7ddsz>W%Mj9GQrR=x3b@n)H=j
zK}0&*=dHpj|JK$BT~&gnrGH*`y4kuG?XI#&Tfld;35$_I)&kPhh|W@fRCc?+f&rX~4
zOP^_~1!M3&nybHO!n@E?Z{FqUMrqYYw>;ZtZ=vMy&brhYfIR=x9O
z_2JgDFa!*eQT@|r(d(b>NrnY0Fw{-lw2ytfgLki(Kcj;ON7bIcKiUa2$y#6xnSu;g
zdTq_uM9bxB{;wCQjR7D+_X6?H5?96;)jX7+W(*M3;wIfoiwquEvHWHKPh
Date: Sun, 21 Dec 2025 22:35:50 +0100
Subject: [PATCH 2/2] docs foundation
---
README.md | 10 ++++
docs/index.md | 33 ++++++++++++
docs/reference/edt-comparison.md | 32 +++++++++++
docs/tutorials/use-cases.md | 61 +++++++++++++++++++++
docs/user-guide/analyst-mode.md | 51 ++++++++++++++++++
docs/user-guide/features.md | 85 ++++++++++++++++++++++++++++++
docs/user-guide/getting-started.md | 38 +++++++++++++
7 files changed, 310 insertions(+)
create mode 100644 docs/index.md
create mode 100644 docs/reference/edt-comparison.md
create mode 100644 docs/tutorials/use-cases.md
create mode 100644 docs/user-guide/analyst-mode.md
create mode 100644 docs/user-guide/features.md
create mode 100644 docs/user-guide/getting-started.md
diff --git a/README.md b/README.md
index b429628..43f34c2 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,16 @@
---
+## 📚 Documentation
+**[Explore the Full Documentation](docs/index.md)**
+
+- **[Getting Started](docs/user-guide/getting-started.md)**
+- **[User Guide & Features](docs/user-guide/features.md)**
+- **[Analyst Mode](docs/user-guide/analyst-mode.md)**
+- **[Video Tutorials](docs/tutorials/use-cases.md)**
+
+---
+
**Football Manager Forge** is a modern, cross-platform tool built to simplify the process of editing `.edt` files for the Football Manager series. These files are used to configure **regens** (newly generated players) before starting a new game.
### ❓ What are Regens?
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..09f2e5d
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,33 @@
+# 📚 FM Forge Documentation
+
+Welcome to the official documentation for **Football Manager Forge**.
+
+FM Forge is a powerful, modern editor for Football Manager `.edt` files, designed to make managing custom databases and regens easier, faster, and less error-prone.
+
+## 📖 Contents
+
+### [🚀 Getting Started](user-guide/getting-started.md)
+- Installation
+- Loading your first file
+- Understanding the interface
+
+### [🛠️ User Guide](user-guide/features.md)
+- **[Core Features](user-guide/features.md)**: Filtering, Sorting, and Searching.
+- **[Editing Players](user-guide/features.md#editing-players)**: Quick Edit, Full Edit, and Mass Edit.
+- **[Analyst Mode](user-guide/analyst-mode.md)**: Visualizing your database.
+
+### [🎥 Tutorials & Use Cases](tutorials/use-cases.md)
+- How to fix player attributes quickly.
+- Updating an entire team's roster.
+- Balancing a retro database.
+- *Video guides included.*
+
+### [🆚 Why FM Forge?](reference/edt-comparison.md)
+- Comparison with traditional text editing.
+- Why `.edt` files are still relevant.
+- Safety and validation features.
+
+---
+
+## 🆘 Need Help?
+If you encounter any bugs or have feature requests, please open an issue on our GitHub repository.
diff --git a/docs/reference/edt-comparison.md b/docs/reference/edt-comparison.md
new file mode 100644
index 0000000..0839a2c
--- /dev/null
+++ b/docs/reference/edt-comparison.md
@@ -0,0 +1,32 @@
+# 🆚 FM Forge vs. Text Editing
+
+Why should you use FM Forge instead of editing `.edt` files in Notepad?
+
+| Feature | 📝 Text Editor (Notepad) | ⚒️ FM Forge |
+| :--- | :--- | :--- |
+| **Ease of Use** | Difficult. Requires memorizing command syntax. | **Easy**. Graphical interface with dropdowns and sliders. |
+| **Validation** | None. Typos break the file. | **Automatic**. Prevents invalid values (e.g., CA > 200). |
+| **IDs & Codes** | Must look up Club/Nation IDs manually. | **Built-in**. Search clubs and nations by name. |
+| **Visualization** | None. Just text. | **Rich**. Charts, graphs, and stats. |
+| **Bulk Editing** | Find & Replace (risky). | **Mass Edit**. Smart relative or absolute changes. |
+| **Safety** | No undo. Easy to overwrite data. | **Safe**. Changes are staged before saving. |
+| **Search** | Basic text search. | **Advanced**. Filter by attributes, position, age, etc. |
+
+## The "Old Way" (EDT Syntax)
+
+Traditionally, you would write lines like this:
+
+```text
+"DETAILED_FUTURE_REGEN" "John" "" "Doe" "20/05/2000" "5" "10" "15" ...
+```
+
+One missing quote or comma would cause the game to ignore the file or crash. You also had to know that `"5"` corresponds to "English" nationality and `"10"` is "Arsenal".
+
+## The FM Forge Way
+
+With FM Forge, you simply:
+1. Select "Arsenal" from a dropdown.
+2. Select "England" from a dropdown.
+3. Use sliders or inputs for attributes.
+
+The application handles the complex syntax generation for you when you save.
diff --git a/docs/tutorials/use-cases.md b/docs/tutorials/use-cases.md
new file mode 100644
index 0000000..11a62bd
--- /dev/null
+++ b/docs/tutorials/use-cases.md
@@ -0,0 +1,61 @@
+# 🎥 Tutorials & Use Cases
+
+Here are some common scenarios where FM Forge shines, with video guides to help you master the workflow.
+
+## 1. Fixing Player Attributes Quickly
+*Scenario: You noticed a winger has very low Pace or a Goalkeeper is too short.*
+
+**Workflow:**
+1. Search for the player by name.
+2. Double-click the attribute cell.
+3. Type the new value.
+4. Press Enter.
+
+
+*(Video coming soon)*
+
+---
+
+## 2. Buffing an Entire Team
+*Scenario: You want to boost the Potential Ability of all youth players in a specific club.*
+
+**Workflow:**
+1. Open Filters.
+2. Select the Club.
+3. Set Age filter (e.g., max 18).
+4. Select All players (checkbox in header).
+5. Click **Mass Edit**.
+6. In the PA field, enter `+10` (to add 10 to everyone) or `160` (to set everyone to 160).
+7. Click Apply.
+
+
+*(Video coming soon)*
+
+---
+
+## 3. Creating a "Class of '92" Scenario
+*Scenario: You want to add a group of high-potential players appearing in the same year.*
+
+**Workflow:**
+1. Click **Add Player**.
+2. Fill in details for the first player.
+3. Set the **Birth Year** to your target year.
+4. Repeat for other players.
+5. Use **Analyst Mode > Temporal** to verify the spike in talent for that year.
+
+
+*(Video coming soon)*
+
+---
+
+## 4. Balancing a Retro Database
+*Scenario: You are converting a database from 2005 to FM24.*
+
+**Workflow:**
+1. Open **Settings**.
+2. Set FM Edition to `24` and Retro Year to `2005`.
+3. Enable **Show Real Birth Dates**.
+4. Now, when you edit Birth Years, you can input "1988" (real year) instead of calculating the in-game year manually.
+
+
+*(Video coming soon)*
diff --git a/docs/user-guide/analyst-mode.md b/docs/user-guide/analyst-mode.md
new file mode 100644
index 0000000..de0c1e2
--- /dev/null
+++ b/docs/user-guide/analyst-mode.md
@@ -0,0 +1,51 @@
+# 📊 Analyst Mode
+
+Switch to the **Analyst View** using the toggle in the top-right corner to visualize your database. This mode is essential for balancing your custom database and ensuring realistic distributions of talent.
+
+
+
+## Sections
+
+### 1. Overview
+A high-level summary of the current dataset (or filtered subset).
+- Total player count.
+- Most common nationality and club.
+- Average CA/PA.
+- Dominant foot distribution.
+
+### 2. Geography
+Interactive map and list showing where your players come from.
+- **Map**: Visual density of player nationalities.
+- **List**: Sortable list of countries by player count.
+
+### 3. Clubs
+Analyze club representation.
+- See which clubs have the most regens.
+- Identify clubs that might be overpowered or underrepresented.
+
+### 4. Positional Analysis
+Breakdown of players by their natural position.
+- Ensure you have enough Goalkeepers, Defenders, Midfielders, and Attackers.
+- Visual bar charts for easy comparison.
+
+### 5. Physical Stats
+Distribution of Height and Weight.
+- **Scatter Plot**: Visualize the correlation between height and weight.
+- **Extremes**: See the tallest, shortest, heaviest, and lightest players.
+
+### 6. Abilities (CA/PA)
+Deep dive into player quality.
+- **Distribution Curves**: See the spread of Current and Potential Ability.
+- **Quartiles**: Box-plot style analysis (Top 25%, Median, Bottom 25%).
+- **Top Prospects**: List of the highest PA players.
+
+### 7. Temporal (Birth Years)
+Analyze the age structure of your database.
+- **Birth Year Distribution**: Ensure you don't have "gap years" where no regens appear.
+- **Month Distribution**: Check for birth month bias.
+
+---
+
+## 💡 Tips
+- **Filters apply to Analyst Mode!** You can filter by "Brazil" and switch to Analyst Mode to see stats specifically for Brazilian players.
+- Use this mode to check if your "Wonderkid" distribution is realistic (e.g., not too many 190+ PA players).
diff --git a/docs/user-guide/features.md b/docs/user-guide/features.md
new file mode 100644
index 0000000..c351534
--- /dev/null
+++ b/docs/user-guide/features.md
@@ -0,0 +1,85 @@
+# 🛠️ Core Features
+
+## 🔍 Browsing & Filtering
+
+FM Forge provides powerful tools to find exactly the players you are looking for.
+
+### Filters Panel
+Click the **Filters** bar to expand the advanced search options.
+
+
+
+- **Name Search**: Type to search by First, Last, or Common name. Supports partial matches.
+- **Country**: Filter by nationality.
+- **Club**: Filter by current club or favourite club.
+- **Position**: Select specific positions (e.g., "Goalkeeper", "Striker").
+- **Attributes**: Set ranges for Current Ability (CA) and Potential Ability (PA).
+- **Physical**: Filter by Preferred Foot.
+- **Personal**: Filter by Birth Year or Favourite Number.
+
+### Sorting
+Click any column header to sort the table. Click again to reverse the order.
+- **Sortable Columns**: Name, Nationality, Club, CA, PA, Age, Height, Weight.
+
+---
+
+## ✏️ Editing Players
+
+There are three ways to edit player data in FM Forge.
+
+### 1. Quick Edit (Inline)
+Perfect for making small adjustments without leaving the list view.
+- **Double-click** on any cell in the table (e.g., a player's CA or Club).
+- The row will switch to **Edit Mode**.
+- Modify the values directly.
+- Press **Enter** or click the **Save** icon to confirm.
+- Press **Escape** to cancel.
+
+
+
+### 2. Full Edit
+For comprehensive changes to a player's profile.
+- Click the **Edit (Pencil)** icon on the right side of a player row.
+- All fields become editable.
+- You can change:
+ - **Personal**: Names, Birth Date, City.
+ - **Club**: Current Club, Favourite Club.
+ - **Attributes**: CA, PA, Foot, Position.
+ - **Appearance**: Ethnicity, Skin Tone, Hair Color, Height, Weight.
+
+### 3. Mass Edit
+Apply changes to multiple players at once.
+1. **Select Players**: Use the checkboxes on the left to select players.
+ * *Tip: Use Shift+Click to select a range.*
+2. Click the **"Mass Edit"** button in the floating action bar.
+3. **Configure Changes**:
+ * **Set Value**: Enter a number (e.g., `150`) to set all selected players to that value.
+ * **Relative Change**: Enter `+10` or `-5` to increase/decrease values relative to each player's current stats.
+4. Click **Apply**.
+
+
+
+---
+
+## ➕ Adding & Deleting
+
+### Adding a Player
+- Click the **"Add Player"** button in the header.
+- A new row will appear at the top of the list.
+- Fill in the details and save.
+
+### Deleting a Player
+- Click the **Delete (Trash)** icon on a player row.
+- The row will be marked for deletion (strikethrough style).
+- **Note**: The player is not removed from the file until you **Save**. You can undo the deletion before saving.
+
+---
+
+## 🔄 Change Tracking
+
+FM Forge keeps track of your changes visually:
+- **Yellow**: Modified player.
+- **Green**: Newly added player.
+- **Red**: Player marked for deletion.
+
+The header shows a counter of how many unsaved changes you have.
diff --git a/docs/user-guide/getting-started.md b/docs/user-guide/getting-started.md
new file mode 100644
index 0000000..89d3992
--- /dev/null
+++ b/docs/user-guide/getting-started.md
@@ -0,0 +1,38 @@
+# 🚀 Getting Started
+
+## Installation
+
+FM Forge is a cross-platform application available for macOS, Windows, and Linux.
+
+1. Download the latest release for your operating system from the [Releases page](../../releases).
+2. **macOS**: Drag the `.app` file to your Applications folder.
+3. **Windows**: Run the installer `.exe`.
+4. **Linux**: Run the `.AppImage` or install the `.deb` package.
+
+## First Launch
+
+When you first open FM Forge, you will be greeted by the main dashboard. The table will be empty until you load a file.
+
+
+*(Screenshot of empty dashboard)*
+
+## Loading Data
+
+1. Click the **"Load File"** button in the top-left corner.
+2. Navigate to your Football Manager data folder (usually where you keep your `.edt` files).
+3. Select one or more `.edt` files.
+ * *Tip: You can select multiple files to merge them into a single view.*
+4. The application will parse the files and display the player records in the table.
+
+### Mod Settings (Optional)
+If you are working with a **Retro Database**, you might want to configure the date offsets:
+1. Click the **Settings** (gear icon) in the header.
+2. Enter the **FM Edition** (e.g., `24` for FM24).
+3. Enter the **Retro Year** (e.g., `2005` for the database year).
+4. Toggle **"Show Real Birth Dates"** to see birth years adjusted to the retro era.
+
+## Saving Your Work
+
+1. Click the **"Save File"** button.
+2. Choose a location and filename.
+3. **Important**: You can choose to save **All Players** or only **Filtered Players**. This is useful if you want to extract a specific subset of players into a new file.