604604 < ul class ="md-nav__list ">
605605
606606 < li class ="md-nav__item ">
607- < a href ="#reset-debug-a-broken -submodule " class ="md-nav__link ">
607+ < a href ="#add-a-new -submodule " class ="md-nav__link ">
608608 < span class ="md-ellipsis ">
609609
610- Reset / Debug a Broken Submodule
610+ Add a New Submodule
611611
612612 </ span >
613613 </ a >
614614
615615</ li >
616616
617617 < li class ="md-nav__item ">
618- < a href ="#add-a-new-submodule " class ="md-nav__link ">
618+ < a href ="#git-pull " class ="md-nav__link ">
619619 < span class ="md-ellipsis ">
620620
621- Add a New Submodule
621+ Git Pull
622+
623+ </ span >
624+ </ a >
625+
626+ </ li >
627+
628+ < li class ="md-nav__item ">
629+ < a href ="#reset-debug-a-broken-submodule " class ="md-nav__link ">
630+ < span class ="md-ellipsis ">
631+
632+ Reset / Debug a Broken Submodule
622633
623634 </ span >
624635 </ a >
@@ -724,20 +735,19 @@ <h2 id="prerequisites">Prerequisites</h2>
724735< hr />
725736< h2 id ="local-development-setup "> Local Development Setup</ h2 >
726737< p > Clone the repository and move into it:</ p >
727- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-0-1 "> < a id ="__codelineno-0-1 " name ="__codelineno-0-1 " href ="#__codelineno-0-1 "> </ a > git< span class ="w "> </ span > clone< span class ="w "> </ span > <repo-url>
728- </ span > < span id ="__span-0-2 "> < a id ="__codelineno-0-2 " name ="__codelineno-0-2 " href ="#__codelineno-0-2 "> </ a > < span class ="nb "> cd</ span > < span class ="w "> </ span > <repo-name>
729- </ span > </ code > </ pre > </ div >
730- < p > Create and activate a virtual environment:</ p >
731- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-1-1 "> < a id ="__codelineno-1-1 " name ="__codelineno-1-1 " href ="#__codelineno-1-1 "> </ a > python3< span class ="w "> </ span > -m< span class ="w "> </ span > venv< span class ="w "> </ span > .venv
732- </ span > < span id ="__span-1-2 "> < a id ="__codelineno-1-2 " name ="__codelineno-1-2 " href ="#__codelineno-1-2 "> </ a > < span class ="nb "> source</ span > < span class ="w "> </ span > .venv/bin/activate
733- </ span > </ code > </ pre > </ div >
734- < p > Install dependencies:</ p >
735- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-2-1 "> < a id ="__codelineno-2-1 " name ="__codelineno-2-1 " href ="#__codelineno-2-1 "> </ a > pip< span class ="w "> </ span > install< span class ="w "> </ span > -r< span class ="w "> </ span > requirements.txt
738+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-0-1 "> < a id ="__codelineno-0-1 " name ="__codelineno-0-1 " href ="#__codelineno-0-1 "> </ a > < span class ="c1 "> # Clone the repository and move into it:</ span >
739+ </ span > < span id ="__span-0-2 "> < a id ="__codelineno-0-2 " name ="__codelineno-0-2 " href ="#__codelineno-0-2 "> </ a > git< span class ="w "> </ span > clone< span class ="w "> </ span > --recurse-submodules< span class ="w "> </ span > https://github.com/codingismeditation/codingismeditation.github.io
740+ </ span > < span id ="__span-0-3 "> < a id ="__codelineno-0-3 " name ="__codelineno-0-3 " href ="#__codelineno-0-3 "> </ a > < span class ="nb "> cd</ span > < span class ="w "> </ span > codingismeditation.github.io
741+ </ span > < span id ="__span-0-4 "> < a id ="__codelineno-0-4 " name ="__codelineno-0-4 " href ="#__codelineno-0-4 "> </ a > git< span class ="w "> </ span > submodule< span class ="w "> </ span > status
742+ </ span > < span id ="__span-0-5 "> < a id ="__codelineno-0-5 " name ="__codelineno-0-5 " href ="#__codelineno-0-5 "> </ a > < span class ="c1 "> # Create and activate a virtual environment & Install dependencies:</ span >
743+ </ span > < span id ="__span-0-6 "> < a id ="__codelineno-0-6 " name ="__codelineno-0-6 " href ="#__codelineno-0-6 "> </ a > python3< span class ="w "> </ span > -m< span class ="w "> </ span > venv< span class ="w "> </ span > .venv
744+ </ span > < span id ="__span-0-7 "> < a id ="__codelineno-0-7 " name ="__codelineno-0-7 " href ="#__codelineno-0-7 "> </ a > < span class ="nb "> source</ span > < span class ="w "> </ span > .venv/bin/activate
745+ </ span > < span id ="__span-0-8 "> < a id ="__codelineno-0-8 " name ="__codelineno-0-8 " href ="#__codelineno-0-8 "> </ a > pip< span class ="w "> </ span > install< span class ="w "> </ span > -r< span class ="w "> </ span > requirements.txt
736746</ span > </ code > </ pre > </ div >
737747< hr />
738748< h2 id ="running-locally "> Running Locally</ h2 >
739749< p > Start the MkDocs development server:</ p >
740- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-3 -1 "> < a id ="__codelineno-3 -1 " name ="__codelineno-3 -1 " href ="#__codelineno-3 -1 "> </ a > mkdocs< span class ="w "> </ span > serve
750+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-1 -1 "> < a id ="__codelineno-1 -1 " name ="__codelineno-1 -1 " href ="#__codelineno-1 -1 "> </ a > mkdocs< span class ="w "> </ span > serve
741751</ span > </ code > </ pre > </ div >
742752< ul >
743753< li > Open: < a href ="http://127.0.0.1:8000 "> http://127.0.0.1:8000</ a > </ li >
@@ -750,53 +760,57 @@ <h2 id="development-completion-checklist">Development Completion Checklist</h2>
750760< ol >
751761< li > Freeze dependencies (only if dependencies changed):</ li >
752762</ ol >
753- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-4 -1 "> < a id ="__codelineno-4 -1 " name ="__codelineno-4 -1 " href ="#__codelineno-4 -1 "> </ a > pip< span class ="w "> </ span > freeze< span class ="w "> </ span > >< span class ="w "> </ span > requirements.txt
763+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-2 -1 "> < a id ="__codelineno-2 -1 " name ="__codelineno-2 -1 " href ="#__codelineno-2 -1 "> </ a > pip< span class ="w "> </ span > freeze< span class ="w "> </ span > >< span class ="w "> </ span > requirements.txt
754764</ span > </ code > </ pre > </ div >
755765< ol >
756766< li > Build the site locally:</ li >
757767</ ol >
758- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-5 -1 "> < a id ="__codelineno-5 -1 " name ="__codelineno-5 -1 " href ="#__codelineno-5 -1 "> </ a > mkdocs< span class ="w "> </ span > build
768+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-3 -1 "> < a id ="__codelineno-3 -1 " name ="__codelineno-3 -1 " href ="#__codelineno-3 -1 "> </ a > mkdocs< span class ="w "> </ span > build
759769</ span > </ code > </ pre > </ div >
760770< ol >
761771< li > Commit and push changes:</ li >
762772</ ol >
763- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-6 -1 "> < a id ="__codelineno-6 -1 " name ="__codelineno-6 -1 " href ="#__codelineno-6 -1 "> </ a > git< span class ="w "> </ span > add< span class ="w "> </ span > .
764- </ span > < span id ="__span-6 -2 "> < a id ="__codelineno-6 -2 " name ="__codelineno-6 -2 " href ="#__codelineno-6 -2 "> </ a > git< span class ="w "> </ span > commit< span class ="w "> </ span > -m< span class ="w "> </ span > < span class ="s2 "> "docs: meaningful commit message"</ span >
765- </ span > < span id ="__span-6 -3 "> < a id ="__codelineno-6 -3 " name ="__codelineno-6 -3 " href ="#__codelineno-6 -3 "> </ a > git< span class ="w "> </ span > push
773+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-4 -1 "> < a id ="__codelineno-4 -1 " name ="__codelineno-4 -1 " href ="#__codelineno-4 -1 "> </ a > git< span class ="w "> </ span > add< span class ="w "> </ span > .
774+ </ span > < span id ="__span-4 -2 "> < a id ="__codelineno-4 -2 " name ="__codelineno-4 -2 " href ="#__codelineno-4 -2 "> </ a > git< span class ="w "> </ span > commit< span class ="w "> </ span > -m< span class ="w "> </ span > < span class ="s2 "> "docs: meaningful commit message"</ span >
775+ </ span > < span id ="__span-4 -3 "> < a id ="__codelineno-4 -3 " name ="__codelineno-4 -3 " href ="#__codelineno-4 -3 "> </ a > git< span class ="w "> </ span > push
766776</ span > </ code > </ pre > </ div >
767777< hr />
768778< h2 id ="deployment-github-pages "> Deployment (GitHub Pages)</ h2 >
769779< p > Deploy documentation using:</ p >
770- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-7 -1 "> < a id ="__codelineno-7 -1 " name ="__codelineno-7 -1 " href ="#__codelineno-7 -1 "> </ a > mkdocs< span class ="w "> </ span > gh-deploy< span class ="w "> </ span > --force
780+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-5 -1 "> < a id ="__codelineno-5 -1 " name ="__codelineno-5 -1 " href ="#__codelineno-5 -1 "> </ a > mkdocs< span class ="w "> </ span > gh-deploy< span class ="w "> </ span > --force
771781</ span > </ code > </ pre > </ div >
772782< p > Then commit and sync again if needed:</ p >
773- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-8 -1 "> < a id ="__codelineno-8 -1 " name ="__codelineno-8 -1 " href ="#__codelineno-8 -1 "> </ a > git< span class ="w "> </ span > add< span class ="w "> </ span > .
774- </ span > < span id ="__span-8 -2 "> < a id ="__codelineno-8 -2 " name ="__codelineno-8 -2 " href ="#__codelineno-8 -2 "> </ a > git< span class ="w "> </ span > commit< span class ="w "> </ span > -m< span class ="w "> </ span > < span class ="s2 "> "deploy: update GitHub Pages"</ span >
775- </ span > < span id ="__span-8 -3 "> < a id ="__codelineno-8 -3 " name ="__codelineno-8 -3 " href ="#__codelineno-8 -3 "> </ a > git< span class ="w "> </ span > push
783+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-6 -1 "> < a id ="__codelineno-6 -1 " name ="__codelineno-6 -1 " href ="#__codelineno-6 -1 "> </ a > git< span class ="w "> </ span > add< span class ="w "> </ span > .
784+ </ span > < span id ="__span-6 -2 "> < a id ="__codelineno-6 -2 " name ="__codelineno-6 -2 " href ="#__codelineno-6 -2 "> </ a > git< span class ="w "> </ span > commit< span class ="w "> </ span > -m< span class ="w "> </ span > < span class ="s2 "> "deploy: update GitHub Pages"</ span >
785+ </ span > < span id ="__span-6 -3 "> < a id ="__codelineno-6 -3 " name ="__codelineno-6 -3 " href ="#__codelineno-6 -3 "> </ a > git< span class ="w "> </ span > push
776786</ span > </ code > </ pre > </ div >
777787< blockquote >
778788< p > < code > --force</ code > is intentional to keep the < code > gh-pages</ code > branch clean and consistent.</ p >
779789</ blockquote >
780790< hr />
781791< h2 id ="working-with-submodules "> Working With Submodules</ h2 >
782792< p > Some documentation sections are maintained as < strong > Git submodules</ strong > .</ p >
793+ < h3 id ="add-a-new-submodule "> Add a New Submodule</ h3 >
794+ < p > < code > eg:kintsugi-stack-networking</ code > </ p >
795+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-7-1 "> < a id ="__codelineno-7-1 " name ="__codelineno-7-1 " href ="#__codelineno-7-1 "> </ a > git< span class ="w "> </ span > submodule< span class ="w "> </ span > add< span class ="w "> </ span > https://github.com/kintsugi-programmer/kintsugi-stack-networking< span class ="w "> </ span > docs/interview/networking
796+ </ span > </ code > </ pre > </ div >
797+ < p > Update < code > .gitmodules</ code > automatically (Git does this).</ p >
798+ < h3 id ="git-pull "> Git Pull</ h3 >
799+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-8-1 "> < a id ="__codelineno-8-1 " name ="__codelineno-8-1 " href ="#__codelineno-8-1 "> </ a > < span class ="c1 "> # do it inside any submodule folder</ span >
800+ </ span > < span id ="__span-8-2 "> < a id ="__codelineno-8-2 " name ="__codelineno-8-2 " href ="#__codelineno-8-2 "> </ a > git< span class ="w "> </ span > pull
801+ </ span > </ code > </ pre > </ div >
783802< h3 id ="reset-debug-a-broken-submodule "> Reset / Debug a Broken Submodule</ h3 >
784803< p > < code > eg:kintsugi-stack-networking</ code > </ p >
785804< div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-9-1 "> < a id ="__codelineno-9-1 " name ="__codelineno-9-1 " href ="#__codelineno-9-1 "> </ a > git< span class ="w "> </ span > submodule< span class ="w "> </ span > deinit< span class ="w "> </ span > -f< span class ="w "> </ span > docs/kintsugi-stack-networking
786805</ span > < span id ="__span-9-2 "> < a id ="__codelineno-9-2 " name ="__codelineno-9-2 " href ="#__codelineno-9-2 "> </ a > rm< span class ="w "> </ span > -rf< span class ="w "> </ span > .git/modules/docs/kintsugi-stack-networking
787806</ span > < span id ="__span-9-3 "> < a id ="__codelineno-9-3 " name ="__codelineno-9-3 " href ="#__codelineno-9-3 "> </ a > rm< span class ="w "> </ span > -rf< span class ="w "> </ span > docs/kintsugi-stack-networking
788807</ span > </ code > </ pre > </ div >
789- < h3 id ="add-a-new-submodule "> Add a New Submodule</ h3 >
790- < p > < code > eg:kintsugi-stack-networking</ code > </ p >
791- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-10-1 "> < a id ="__codelineno-10-1 " name ="__codelineno-10-1 " href ="#__codelineno-10-1 "> </ a > git< span class ="w "> </ span > submodule< span class ="w "> </ span > add< span class ="w "> </ span > https://github.com/kintsugi-programmer/kintsugi-stack-networking< span class ="w "> </ span > docs/interview/networking
792- </ span > </ code > </ pre > </ div >
793- < p > Update < code > .gitmodules</ code > automatically (Git does this).</ p >
794808< hr />
795809< h2 id ="mkdocs-navigation-update "> MkDocs Navigation Update</ h2 >
796810< p > After adding a submodule, update < code > mkdocs.yml</ code > :</ p >
797- < div class ="language-yaml highlight "> < pre > < span > </ span > < code > < span id ="__span-11 -1 "> < a id ="__codelineno-11 -1 " name ="__codelineno-11 -1 " href ="#__codelineno-11 -1 "> </ a > < span class ="nt "> nav</ span > < span class ="p "> :</ span >
798- </ span > < span id ="__span-11 -2 "> < a id ="__codelineno-11 -2 " name ="__codelineno-11 -2 " href ="#__codelineno-11 -2 "> </ a > < span class ="w "> </ span > < span class ="p p-Indicator "> -</ span > < span class ="w "> </ span > < span class ="nt "> Home</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="l l-Scalar l-Scalar-Plain "> index.md</ span >
799- </ span > < span id ="__span-11 -3 "> < a id ="__codelineno-11 -3 " name ="__codelineno-11 -3 " href ="#__codelineno-11 -3 "> </ a > < span class ="w "> </ span > < span class ="p p-Indicator "> -</ span > < span class ="w "> </ span > < span class ="nt "> Networking</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="l l-Scalar l-Scalar-Plain "> interview/networking/index.md</ span >
811+ < div class ="language-yaml highlight "> < pre > < span > </ span > < code > < span id ="__span-10 -1 "> < a id ="__codelineno-10 -1 " name ="__codelineno-10 -1 " href ="#__codelineno-10 -1 "> </ a > < span class ="nt "> nav</ span > < span class ="p "> :</ span >
812+ </ span > < span id ="__span-10 -2 "> < a id ="__codelineno-10 -2 " name ="__codelineno-10 -2 " href ="#__codelineno-10 -2 "> </ a > < span class ="w "> </ span > < span class ="p p-Indicator "> -</ span > < span class ="w "> </ span > < span class ="nt "> Home</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="l l-Scalar l-Scalar-Plain "> index.md</ span >
813+ </ span > < span id ="__span-10 -3 "> < a id ="__codelineno-10 -3 " name ="__codelineno-10 -3 " href ="#__codelineno-10 -3 "> </ a > < span class ="w "> </ span > < span class ="p p-Indicator "> -</ span > < span class ="w "> </ span > < span class ="nt "> Networking</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="l l-Scalar l-Scalar-Plain "> interview/networking/index.md</ span >
800814</ span > </ code > </ pre > </ div >
801815< p > Ensure:</ p >
802816< ul >
@@ -822,7 +836,7 @@ <h2 id="commit-message-convention-recommended">Commit Message Convention (Recomm
822836< li > < code > deploy:</ code > GitHub Pages updates</ li >
823837</ ul >
824838< p > Example:</ p >
825- < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-12 -1 "> < a id ="__codelineno-12 -1 " name ="__codelineno-12 -1 " href ="#__codelineno-12 -1 "> </ a > git< span class ="w "> </ span > commit< span class ="w "> </ span > -m< span class ="w "> </ span > < span class ="s2 "> "docs: add networking interview section"</ span >
839+ < div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-11 -1 "> < a id ="__codelineno-11 -1 " name ="__codelineno-11 -1 " href ="#__codelineno-11 -1 "> </ a > git< span class ="w "> </ span > commit< span class ="w "> </ span > -m< span class ="w "> </ span > < span class ="s2 "> "docs: add networking interview section"</ span >
826840</ span > </ code > </ pre > </ div >
827841< hr />
828842< h2 id ="need-help "> Need Help?</ h2 >
@@ -855,7 +869,7 @@ <h2 id="need-help">Need Help?</h2>
855869 < span class ="md-icon " title ="Last update ">
856870 < svg xmlns ="http://www.w3.org/2000/svg " viewBox ="0 0 24 24 "> < path d ="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z "/> </ svg >
857871 </ span >
858- < span class ="git-revision-date-localized-plugin git-revision-date-localized-plugin-date " title ="February 9 , 2026 00:23:16 UTC "> February 9 , 2026</ span >
872+ < span class ="git-revision-date-localized-plugin git-revision-date-localized-plugin-date " title ="February 10 , 2026 18:10:11 UTC "> February 10 , 2026</ span >
859873 </ span >
860874
861875
0 commit comments