[{"data":1,"prerenderedAt":682},["ShallowReactive",2],{"navigation_docs":3,"-advanced-go-advanced-roadmap":377,"-advanced-go-advanced-roadmap-surround":677},[4,39,114,144,184,244,293,362],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Learning Path","\u002Fgetting-started\u002Flearning-path","1.getting-started\u002F1.learning-path","i-lucide-map",{"title":16,"path":17,"stem":18,"icon":19},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":21,"path":22,"stem":23,"icon":24},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F3.installation","i-lucide-download",{"title":26,"path":27,"stem":28,"icon":29},"Your First Program","\u002Fgetting-started\u002Ffirst-program","1.getting-started\u002F4.first-program","i-lucide-play",{"title":31,"path":32,"stem":33,"icon":34},"Modules and Dependencies","\u002Fgetting-started\u002Fmodules-and-dependencies","1.getting-started\u002F5.modules-and-dependencies","i-lucide-package-open",{"title":36,"path":37,"stem":38,"icon":34},"Advanced Modules","\u002Fgetting-started\u002Fadvanced-modules","1.getting-started\u002F6.advanced-modules",{"title":40,"path":41,"stem":42,"children":43,"page":6},"Fundamentals","\u002Ffundamentals","2.fundamentals",[44,49,54,59,64,69,74,79,84,89,94,99,104,109],{"title":45,"path":46,"stem":47,"icon":48},"Program Structure","\u002Ffundamentals\u002Fprogram-structure","2.fundamentals\u002F1.program-structure","i-lucide-workflow",{"title":50,"path":51,"stem":52,"icon":53},"Structs and Methods","\u002Ffundamentals\u002Fstructs-and-methods","2.fundamentals\u002F10.structs-and-methods","i-lucide-box",{"title":55,"path":56,"stem":57,"icon":58},"Interfaces","\u002Ffundamentals\u002Finterfaces","2.fundamentals\u002F11.interfaces","i-lucide-plug",{"title":60,"path":61,"stem":62,"icon":63},"Error Handling","\u002Ffundamentals\u002Ferrors","2.fundamentals\u002F12.errors","i-lucide-triangle-alert",{"title":65,"path":66,"stem":67,"icon":68},"Defined Types and Type Aliases","\u002Ffundamentals\u002Fdefined-types","2.fundamentals\u002F13.defined-types","i-lucide-tags",{"title":70,"path":71,"stem":72,"icon":73},"Generics","\u002Ffundamentals\u002Fgenerics","2.fundamentals\u002F14.generics","i-lucide-blocks",{"title":75,"path":76,"stem":77,"icon":78},"Project Structure","\u002Ffundamentals\u002Fproject-structure","2.fundamentals\u002F2.project-structure","i-lucide-folder-tree",{"title":80,"path":81,"stem":82,"icon":83},"Project Layout","\u002Ffundamentals\u002Fproject-layout","2.fundamentals\u002F3.project-layout","i-lucide-layout",{"title":85,"path":86,"stem":87,"icon":88},"Variables and Data Types","\u002Ffundamentals\u002Fvariables-and-types","2.fundamentals\u002F4.variables-and-types","i-lucide-variable",{"title":90,"path":91,"stem":92,"icon":93},"Functions","\u002Ffundamentals\u002Ffunctions","2.fundamentals\u002F5.functions","i-lucide-braces",{"title":95,"path":96,"stem":97,"icon":98},"Control Statements","\u002Ffundamentals\u002Fcontrol-statements","2.fundamentals\u002F6.control-statements","i-lucide-git-branch",{"title":100,"path":101,"stem":102,"icon":103},"Pointers","\u002Ffundamentals\u002Fpointers","2.fundamentals\u002F7.pointers","i-lucide-mouse-pointer-2",{"title":105,"path":106,"stem":107,"icon":108},"Arrays and Slices","\u002Ffundamentals\u002Farrays-and-slices","2.fundamentals\u002F8.arrays-and-slices","i-lucide-list",{"title":110,"path":111,"stem":112,"icon":113},"Maps","\u002Ffundamentals\u002Fmaps","2.fundamentals\u002F9.maps","i-lucide-table-properties",{"title":115,"path":116,"stem":117,"children":118,"page":6},"Concurrency","\u002Fconcurrency","3.concurrency",[119,124,129,134,139],{"title":120,"path":121,"stem":122,"icon":123},"Concurrency Model","\u002Fconcurrency\u002Fconcurrency-model","3.concurrency\u002F1.concurrency-model","i-lucide-network",{"title":125,"path":126,"stem":127,"icon":128},"Goroutines","\u002Fconcurrency\u002Fgoroutines","3.concurrency\u002F2.goroutines","i-lucide-git-fork",{"title":130,"path":131,"stem":132,"icon":133},"Channels","\u002Fconcurrency\u002Fchannels","3.concurrency\u002F3.channels","i-lucide-arrow-left-right",{"title":135,"path":136,"stem":137,"icon":138},"Select and Cancellation","\u002Fconcurrency\u002Fselect-and-cancellation","3.concurrency\u002F4.select-and-cancellation","i-lucide-circle-stop",{"title":140,"path":141,"stem":142,"icon":143},"Synchronization","\u002Fconcurrency\u002Fsynchronization","3.concurrency\u002F5.synchronization","i-lucide-lock-keyhole",{"title":145,"path":146,"stem":147,"children":148,"page":6},"Standard Library","\u002Fstandard-library","4.standard-library",[149,154,159,164,169,174,179],{"title":150,"path":151,"stem":152,"icon":153},"Standard Library Overview","\u002Fstandard-library\u002Foverview","4.standard-library\u002F1.overview","i-lucide-library",{"title":155,"path":156,"stem":157,"icon":158},"Text and Formatting","\u002Fstandard-library\u002Ftext-and-formatting","4.standard-library\u002F2.text-and-formatting","i-lucide-text",{"title":160,"path":161,"stem":162,"icon":163},"Files and JSON","\u002Fstandard-library\u002Ffiles-and-json","4.standard-library\u002F3.files-and-json","i-lucide-file-json",{"title":165,"path":166,"stem":167,"icon":168},"HTTP Clients and Servers","\u002Fstandard-library\u002Fhttp","4.standard-library\u002F4.http","i-lucide-server",{"title":170,"path":171,"stem":172,"icon":173},"Testing","\u002Fstandard-library\u002Ftesting","4.standard-library\u002F5.testing","i-lucide-flask-conical",{"title":175,"path":176,"stem":177,"icon":178},"Command-Line Tools and Configuration","\u002Fstandard-library\u002Fcommand-line-and-configuration","4.standard-library\u002F6.command-line-and-configuration","i-lucide-terminal-square",{"title":180,"path":181,"stem":182,"icon":183},"Structured Logging","\u002Fstandard-library\u002Fstructured-logging","4.standard-library\u002F7.structured-logging","i-lucide-scroll-text",{"title":185,"path":186,"stem":187,"children":188,"page":6},"Backend Development","\u002Fbackend-development","5.backend-development",[189,194,199,204,209,214,219,224,229,234,239],{"title":190,"path":191,"stem":192,"icon":193},"Backend Roadmap","\u002Fbackend-development\u002Fbackend-roadmap","5.backend-development\u002F1.backend-roadmap","i-lucide-route",{"title":195,"path":196,"stem":197,"icon":198},"Graceful Shutdown","\u002Fbackend-development\u002Fgraceful-shutdown","5.backend-development\u002F10.graceful-shutdown","i-lucide-power",{"title":200,"path":201,"stem":202,"icon":203},"Production Checklist","\u002Fbackend-development\u002Fproduction-checklist","5.backend-development\u002F11.production-checklist","i-lucide-clipboard-check",{"title":205,"path":206,"stem":207,"icon":208},"HTTP API Design","\u002Fbackend-development\u002Fhttp-api-design","5.backend-development\u002F2.http-api-design","i-lucide-waypoints",{"title":210,"path":211,"stem":212,"icon":213},"Middleware","\u002Fbackend-development\u002Fmiddleware","5.backend-development\u002F3.middleware","i-lucide-layers-3",{"title":215,"path":216,"stem":217,"icon":218},"Validation","\u002Fbackend-development\u002Fvalidation","5.backend-development\u002F4.validation","i-lucide-list-checks",{"title":220,"path":221,"stem":222,"icon":223},"Application Wiring","\u002Fbackend-development\u002Fapplication-wiring","5.backend-development\u002F5.application-wiring","i-lucide-cable",{"title":225,"path":226,"stem":227,"icon":228},"Observability","\u002Fbackend-development\u002Fobservability","5.backend-development\u002F6.observability","i-lucide-activity",{"title":230,"path":231,"stem":232,"icon":233},"Database SQL","\u002Fbackend-development\u002Fdatabase-sql","5.backend-development\u002F7.database-sql","i-lucide-database",{"title":235,"path":236,"stem":237,"icon":238},"Transactions","\u002Fbackend-development\u002Ftransactions","5.backend-development\u002F8.transactions","i-lucide-repeat-2",{"title":240,"path":241,"stem":242,"icon":243},"Authentication and Authorization","\u002Fbackend-development\u002Fauthentication","5.backend-development\u002F9.authentication","i-lucide-shield-check",{"title":245,"path":246,"stem":247,"children":248,"page":6},"Advanced Go","\u002Fadvanced-go","6.advanced-go",[249,254,259,264,269,274,278,283,288],{"title":250,"path":251,"stem":252,"icon":253},"Advanced Go Roadmap","\u002Fadvanced-go\u002Fadvanced-roadmap","6.advanced-go\u002F1.advanced-roadmap","i-lucide-brain-circuit",{"title":255,"path":256,"stem":257,"icon":258},"Reflection","\u002Fadvanced-go\u002Freflection","6.advanced-go\u002F2.reflection","i-lucide-scan-search",{"title":260,"path":261,"stem":262,"icon":263},"Memory and Garbage Collection","\u002Fadvanced-go\u002Fmemory-and-garbage-collection","6.advanced-go\u002F3.memory-and-garbage-collection","i-lucide-memory-stick",{"title":265,"path":266,"stem":267,"icon":268},"Benchmarking and Profiling","\u002Fadvanced-go\u002Fbenchmarking-and-profiling","6.advanced-go\u002F4.benchmarking-and-profiling","i-lucide-gauge",{"title":270,"path":271,"stem":272,"icon":273},"Advanced Testing and Fuzzing","\u002Fadvanced-go\u002Fadvanced-testing-and-fuzzing","6.advanced-go\u002F5.advanced-testing-and-fuzzing","i-lucide-microscope",{"title":275,"path":276,"stem":277,"icon":48},"Advanced Concurrency","\u002Fadvanced-go\u002Fadvanced-concurrency","6.advanced-go\u002F6.advanced-concurrency",{"title":279,"path":280,"stem":281,"icon":282},"Unsafe and C Boundaries","\u002Fadvanced-go\u002Funsafe-and-cgo","6.advanced-go\u002F7.unsafe-and-cgo","i-lucide-radiation",{"title":284,"path":285,"stem":286,"icon":287},"Package and API Design","\u002Fadvanced-go\u002Fpackage-and-api-design","6.advanced-go\u002F8.package-and-api-design","i-lucide-boxes",{"title":289,"path":290,"stem":291,"icon":292},"Distributed Reliability","\u002Fadvanced-go\u002Fdistributed-reliability","6.advanced-go\u002F9.distributed-reliability","i-lucide-cloud-cog",{"title":294,"path":295,"stem":296,"children":297,"page":6},"Projects","\u002Fprojects","7.projects",[298,316,332,347],{"title":299,"path":300,"stem":301,"children":302,"icon":305},"CLI Task Manager","\u002Fprojects\u002Fcli-task-manager","7.projects\u002F1.cli-task-manager\u002Findex",[303,306,311],{"title":304,"path":300,"stem":301,"icon":305},"Project — CLI Task Manager","i-lucide-list-todo",{"title":307,"path":308,"stem":309,"icon":310},"CLI — Domain and Storage","\u002Fprojects\u002Fcli-task-manager\u002Fdomain-and-storage","7.projects\u002F1.cli-task-manager\u002F1.domain-and-storage","i-lucide-save",{"title":312,"path":313,"stem":314,"icon":315},"CLI — Commands and Tests","\u002Fprojects\u002Fcli-task-manager\u002Fcommands-and-tests","7.projects\u002F1.cli-task-manager\u002F2.commands-and-tests","i-lucide-terminal",{"title":317,"path":318,"stem":319,"children":320,"icon":323},"Concurrent URL Checker","\u002Fprojects\u002Fconcurrent-url-checker","7.projects\u002F2.concurrent-url-checker\u002Findex",[321,324,328],{"title":322,"path":318,"stem":319,"icon":323},"Project — Concurrent URL Checker","i-lucide-radar",{"title":325,"path":326,"stem":327,"icon":128},"URL Checker — Worker Pipeline","\u002Fprojects\u002Fconcurrent-url-checker\u002Fworker-pipeline","7.projects\u002F2.concurrent-url-checker\u002F1.worker-pipeline",{"title":329,"path":330,"stem":331,"icon":173},"URL Checker — Cancellation and Tests","\u002Fprojects\u002Fconcurrent-url-checker\u002Fcancellation-and-tests","7.projects\u002F2.concurrent-url-checker\u002F2.cancellation-and-tests",{"title":333,"path":334,"stem":335,"children":336},"File-backed API","\u002Fprojects\u002Ffile-backed-api","7.projects\u002F3.file-backed-api\u002Findex",[337,339,343],{"title":338,"path":334,"stem":335},"File-backed notes API",{"title":340,"path":341,"stem":342},"File store and concurrency","\u002Fprojects\u002Ffile-backed-api\u002Ffile-store-and-concurrency","7.projects\u002F3.file-backed-api\u002F1.file-store-and-concurrency",{"title":344,"path":345,"stem":346},"HTTP layer and tests","\u002Fprojects\u002Ffile-backed-api\u002Fhttp-and-tests","7.projects\u002F3.file-backed-api\u002F2.http-and-tests",{"title":348,"path":349,"stem":350,"children":351},"Production REST API","\u002Fprojects\u002Fproduction-rest-api","7.projects\u002F4.production-rest-api\u002Findex",[352,354,358],{"title":353,"path":349,"stem":350},"Production REST API capstone",{"title":355,"path":356,"stem":357},"Persistence and authentication","\u002Fprojects\u002Fproduction-rest-api\u002Fpersistence-and-auth","7.projects\u002F4.production-rest-api\u002F1.persistence-and-auth",{"title":359,"path":360,"stem":361},"Operations and release","\u002Fprojects\u002Fproduction-rest-api\u002Foperations-and-release","7.projects\u002F4.production-rest-api\u002F2.operations-and-release",{"title":363,"path":364,"stem":365,"children":366,"page":6},"Meta","\u002Fmeta","99.meta",[367,372],{"title":368,"path":369,"stem":370,"icon":371},"About","\u002Fmeta\u002Fabout","99.meta\u002F1.about","i-lucide-info",{"title":373,"path":374,"stem":375,"icon":376},"Acknowledgements","\u002Fmeta\u002Facknowledgements","99.meta\u002F2.acknowledgements","i-lucide-heart-handshake",{"id":378,"title":250,"body":379,"description":669,"extension":670,"links":671,"meta":672,"navigation":673,"path":251,"seo":674,"stem":252,"__hash__":676},"docs\u002F6.advanced-go\u002F1.advanced-roadmap.md",{"type":380,"value":381,"toc":652},"minimark",[382,388,393,397,416,420,423,437,440,444,449,452,456,459,463,466,470,516,520,531,534,538,561,565,601,605,608,625,629,646,649],[383,384],"learning-lesson-meta",{"level":385,"prerequisites":386,"time":387},"Advanced","Fundamentals, concurrency, testing, and at least one complete project","25–35 minutes",[389,390,392],"h2",{"id":391},"what-you-will-learn","What you will learn",[394,395,396],"p",{},"By the end of this lesson, you will be able to:",[398,399,400,404,407,410,413],"ul",{},[401,402,403],"li",{},"distinguish advanced knowledge from unnecessary complexity;",[401,405,406],{},"identify which runtime details are implementation-specific;",[401,408,409],{},"choose evidence before optimisation;",[401,411,412],{},"plan deliberate study of reflection, memory, diagnostics, and concurrency;",[401,414,415],{},"recognise when a simple design remains the expert choice.",[389,417,419],{"id":418},"advanced-does-not-mean-clever","Advanced does not mean clever",[394,421,422],{},"Advanced Go is not a collection of tricks. It is the ability to make correct trade-offs while understanding:",[398,424,425,428,431,434],{},[401,426,427],{},"what the language guarantees;",[401,429,430],{},"what the current toolchain implements;",[401,432,433],{},"what the operating system or external service controls;",[401,435,436],{},"what the workload actually requires.",[394,438,439],{},"A small synchronous function can be more advanced engineering than a generic concurrent abstraction if it makes ownership and failure clearer.",[389,441,443],{"id":442},"three-kinds-of-knowledge","Three kinds of knowledge",[445,446,448],"h3",{"id":447},"language-guarantees","Language guarantees",[394,450,451],{},"The Go specification defines syntax, type identity, assignment, method sets, evaluation, and other language behaviour. Code may rely on these guarantees across conforming implementations.",[445,453,455],{"id":454},"standard-library-contracts","Standard-library contracts",[394,457,458],{},"Package documentation defines API behaviour. Read it closely for concurrency safety, ownership, errors, and lifecycle requirements.",[445,460,462],{"id":461},"implementation-details","Implementation details",[394,464,465],{},"Compiler escape decisions, garbage collector tuning, scheduler behaviour, object layout, and generated machine code can change between releases and targets. Measure and revalidate when relying on them for performance.",[389,467,469],{"id":468},"the-advanced-sequence","The advanced sequence",[471,472,473,480,486,492,498,504,510],"ol",{},[401,474,475,479],{},[476,477,478],"strong",{},"Reflection:"," runtime inspection with explicit safety boundaries.",[401,481,482,485],{},[476,483,484],{},"Memory and garbage collection:"," reachability, allocation, escape analysis, and retention.",[401,487,488,491],{},[476,489,490],{},"Benchmarks and profiling:"," produce evidence before changing code.",[401,493,494,497],{},[476,495,496],{},"Advanced testing and fuzzing:"," explore larger input spaces and difficult boundaries.",[401,499,500,503],{},[476,501,502],{},"Advanced concurrency:"," bounded pipelines, cancellation, backpressure, and ownership.",[401,505,506,509],{},[476,507,508],{},"Unsafe and C boundaries:"," know when guarantees are being left behind.",[401,511,512,515],{},[476,513,514],{},"Package and API design:"," make code easier to use correctly over time.",[389,517,519],{"id":518},"a-responsible-optimisation-loop","A responsible optimisation loop",[521,522,528],"pre",{"className":523,"code":525,"language":526,"meta":527},[524],"language-text","define the user-visible problem\n  ↓\ncapture a representative baseline\n  ↓\nprofile or trace the real bottleneck\n  ↓\nchange one relevant factor\n  ↓\nverify correctness\n  ↓\nmeasure again\n","text","",[529,530,525],"code",{"__ignoreMap":527},[394,532,533],{},"If the metric that matters does not improve, revert the complexity.",[389,535,537],{"id":536},"questions-advanced-engineers-ask","Questions advanced engineers ask",[398,539,540,543,546,549,552,555,558],{},[401,541,542],{},"Who owns this data and resource?",[401,544,545],{},"What cancels or bounds this work?",[401,547,548],{},"Which failures are expected, retryable, or ambiguous?",[401,550,551],{},"Is this behaviour guaranteed or merely observed today?",[401,553,554],{},"What evidence shows this is the bottleneck?",[401,556,557],{},"Can the caller use the API incorrectly without noticing?",[401,559,560],{},"How will the system be tested, diagnosed, upgraded, and rolled back?",[389,562,564],{"id":563},"common-mistakes","Common mistakes",[398,566,567,573,579,589,595],{},[401,568,569,572],{},[476,570,571],{},"Reading runtime source before mastering APIs:"," implementation detail replaces usable knowledge.",[401,574,575,578],{},[476,576,577],{},"Optimising benchmark toys:"," production performance remains unchanged.",[401,580,581,588],{},[476,582,583,584,587],{},"Using reflection or ",[529,585,586],{},"unsafe"," to reduce typing:"," compile-time guarantees are traded away without need.",[401,590,591,594],{},[476,592,593],{},"Adding concurrency to CPU-light work:"," coordination cost and failure complexity increase.",[401,596,597,600],{},[476,598,599],{},"Assuming senior code is abstract code:"," long-lived Go code often favours explicit, boring boundaries.",[389,602,604],{"id":603},"practice","Practice",[394,606,607],{},"Choose one working Go program. Classify five facts you rely on as language guarantees, package contracts, or implementation details. Identify one performance belief that needs measurement and one API that could make incorrect use harder.",[609,610,611],"accordion",{},[612,613,616,622],"accordion-item",{"icon":614,"label":615},"i-lucide-lightbulb","Show an example analysis",[521,617,620],{"className":618,"code":619,"language":526,"meta":527},[524],"Language guarantee\n- Assignment of an array copies its elements.\n\nPackage contract\n- http.Server.Shutdown waits for active connections to become idle within context bounds.\n\nImplementation detail\n- A particular local variable remains on the stack in the current build.\n\nNeeds measurement\n- Replacing JSON encoding with a custom encoder will improve endpoint latency.\n\nSafer API\n- Replace Update(id, map[string]any) with a typed UpdateLesson command.\n",[529,621,619],{"__ignoreMap":527},[394,623,624],{},"The implementation detail can be inspected, but correctness must not depend on a current escape decision. The performance idea requires an endpoint profile and representative benchmark before adopting a more complex encoder.",[389,626,628],{"id":627},"summary","Summary",[398,630,631,634,637,640,643],{},[401,632,633],{},"Advanced Go is disciplined reasoning, not unusual syntax.",[401,635,636],{},"Separate specification guarantees, API contracts, and implementation details.",[401,638,639],{},"Use representative evidence before optimisation.",[401,641,642],{},"Prefer designs that expose ownership, cancellation, and failure.",[401,644,645],{},"Remove complexity that does not improve the result that matters.",[647,648],"learning-lesson-complete",{},[650,651],"learning-lesson-navigation",{"next":256,"next-label":255,"previous":201,"previous-label":200},{"title":527,"searchDepth":653,"depth":653,"links":654},2,[655,656,657,663,664,665,666,667,668],{"id":391,"depth":653,"text":392},{"id":418,"depth":653,"text":419},{"id":442,"depth":653,"text":443,"children":658},[659,661,662],{"id":447,"depth":660,"text":448},3,{"id":454,"depth":660,"text":455},{"id":461,"depth":660,"text":462},{"id":468,"depth":653,"text":469},{"id":518,"depth":653,"text":519},{"id":536,"depth":653,"text":537},{"id":563,"depth":653,"text":564},{"id":603,"depth":653,"text":604},{"id":627,"depth":653,"text":628},"Move from writing correct Go to reasoning about runtime behaviour, performance, APIs, and system boundaries.","md",null,{},{"icon":253},{"description":675,"title":250},"A structured advanced Go roadmap covering reflection, memory, profiling, fuzzing, concurrency, unsafe boundaries, and API design.","Bu1OMR83HeqOfel0BeYXnGQCz77yuZxURRXiS-1v-sU",[678,680],{"title":240,"path":241,"stem":242,"description":679,"icon":243,"children":-1},"Verify identity, enforce permissions, protect sessions, and avoid common web-security mistakes.",{"title":255,"path":256,"stem":257,"description":681,"icon":258,"children":-1},"Inspect types and values at runtime while containing panics, complexity, and lost type safety.",1794118092726]