feat: Add table of contents generator for manager book

.pre-commit-config.yaml

@@ -74,3 +74,11 @@ repos:
         exclude: "^zz-chop-logs/.*$|back-links.json" # Exclude the zz-chop-logs directory
         pass_filenames: true
         verbose: true
+
+      - id: update-manager-book-toc
+        name: Update manager book table of contents
+        entry: python scripts/generate_toc.py manager-book
+        language: system
+        files: '^(_posts/2016-03-03-the-manager-book-2\.md|_d/manager-book-appendix\.md)$'
+        pass_filenames: false
+        verbose: true

_d/manager-book-appendix.md

@@ -13,6 +13,134 @@ A hodgepodge of additional resources for the manager book.
 <!-- prettier-ignore-start -->
 <!-- vim-markdown-toc-start -->
 
+- [What does a manager do](/manager-book#what-does-a-manager-do)
+  - [What are a manager's responsibilities](/manager-book#what-are-a-managers-responsibilities)
+  - [How do you measure their success](/manager-book#how-do-you-measure-their-success)
+  - [What is a manager accountable for](/manager-book#what-is-a-manager-accountable-for)
+  - [How do you describe your job to people outside the industry](/manager-book#how-do-you-describe-your-job-to-people-outside-the-industry)
+  - [Hardest part about being a manager](/manager-book#hardest-part-about-being-a-manager)
+  - [The Impact Pyramid](/manager-book#the-impact-pyramid)
+  - [What do you do in the first 90 days](/manager-book#what-do-you-do-in-the-first-90-days)
+  - [What do managers do all day](/manager-book#what-do-managers-do-all-day)
+  - [Should managers be technical](/manager-book#should-managers-be-technical)
+  - [Should managers code](/manager-book#should-managers-code)
+  - [What engineering efficiency metrics should a manager monitor?](/manager-book#what-engineering-efficiency-metrics-should-a-manager-monitor)
+- [Managing and Developing People](/manager-book#managing-and-developing-people)
+  - [How do you coach](/manager-book#how-do-you-coach)
+  - [What mechanisms do you have to ensure career development](/manager-book#what-mechanisms-do-you-have-to-ensure-career-development)
+  - [How do you support folks with their career growth plans (CGPs)](/manager-book#how-do-you-support-folks-with-their-career-growth-plans-cgps)
+  - [How do you support folks by pre-writing self assessments](/manager-book#how-do-you-support-folks-by-pre-writing-self-assessments)
+  - [How do you give fast, frequent, feedback](/manager-book#how-do-you-give-fast-frequent-feedback)
+  - [What do you recommend for folks who just joined the team](/manager-book#what-do-you-recommend-for-folks-who-just-joined-the-team)
+  - [How do you think about situational leadership](/manager-book#how-do-you-think-about-situational-leadership)
+  - [What are the level specific career expectations and growth strategies](/manager-book#what-are-the-level-specific-career-expectations-and-growth-strategies)
+  - [How do you get engineers promoted, and to understand their path to promo?](/manager-book#how-do-you-get-engineers-promoted-and-to-understand-their-path-to-promo)
+  - [How do you help people switch jobs](/manager-book#how-do-you-help-people-switch-jobs)
+  - [How do you keep people motivated](/manager-book#how-do-you-keep-people-motivated)
+  - [How to motivate through personal experience](/manager-book#how-to-motivate-through-personal-experience)
+  - [How to motivate through team environment](/manager-book#how-to-motivate-through-team-environment)
+  - [How do you handle task overload](/manager-book#how-do-you-handle-task-overload)
+  - [How do you give challenging feedback](/manager-book#how-do-you-give-challenging-feedback)
+  - [What's the point of 1:1s](/manager-book#whats-the-point-of-11s)
+  - [What do you do in 1:1s](/manager-book#what-do-you-do-in-11s)
+  - [How do you handle communication problems](/manager-book#how-do-you-handle-communication-problems)
+  - [How do you identify and help eng decide if management is right for them](/manager-book#how-do-you-identify-and-help-eng-decide-if-management-is-right-for-them)
+  - [How do you grow new EMs](/manager-book#how-do-you-grow-new-ems)
+  - [How do you grow top talent](/manager-book#how-do-you-grow-top-talent)
+  - [How do I help people raise concerns/give constructive feedback?](/manager-book#how-do-i-help-people-raise-concernsgive-constructive-feedback)
+  - [Recall career is just one part of your life](/manager-book#recall-career-is-just-one-part-of-your-life)
+  - [How do you have a difficult conversation](/manager-book#how-do-you-have-a-difficult-conversation)
+  - [Should employees game the system to optimize for the review process?](/manager-book#should-employees-game-the-system-to-optimize-for-the-review-process)
+- [Culture](/manager-book#culture)
+  - [What is your ideal culture](/manager-book#what-is-your-ideal-culture)
+  - [How do you help a team gel](/manager-book#how-do-you-help-a-team-gel)
+  - [What order would you introduce culture](/manager-book#what-order-would-you-introduce-culture)
+  - [How do you make a good culture](/manager-book#how-do-you-make-a-good-culture)
+  - [How do you think about ad-hoc insights/questions from others, even if you've already thought of and maybe presented the doc/plan/answer already?](/manager-book#how-do-you-think-about-ad-hoc-insightsquestions-from-others-even-if-youve-already-thought-of-and-maybe-presented-the-docplananswer-already)
+  - [How do you handle Remote Work](/manager-book#how-do-you-handle-remote-work)
+  - [What about Work Life Balance](/manager-book#what-about-work-life-balance)
+  - [How do you deal with a team that disagrees with the leadership](/manager-book#how-do-you-deal-with-a-team-that-disagrees-with-the-leadership)
+  - [Agency and Psychological Safety](/manager-book#agency-and-psychological-safety)
+  - [Kudos Boards - Appreciations](/manager-book#kudos-boards-appreciations)
+  - [How do you like being questioned/micromanaged?](/manager-book#how-do-you-like-being-questionedmicromanaged)
+  - [How do you transition from mercenaries to missionaries](/manager-book#how-do-you-transition-from-mercenaries-to-missionaries)
+- [Process and Mechanism](/manager-book#process-and-mechanism)
+  - [Theory of Process](/manager-book#theory-of-process)
+  - [The dark side of process](/manager-book#the-dark-side-of-process)
+  - [On Change](/manager-book#on-change)
+  - [That sounds like good intentions - Factories and Artisans](/manager-book#that-sounds-like-good-intentions-factories-and-artisans)
+  - [Never have a human do what a computer can do](/manager-book#never-have-a-human-do-what-a-computer-can-do)
+  - [Rich communication - Team meeting](/manager-book#rich-communication-team-meeting)
+  - [Continuous Learning - Deep Dives, Knowledge Transfer and Guest Speakers](/manager-book#continuous-learning-deep-dives-knowledge-transfer-and-guest-speakers)
+  - [Engineering Excellence - Operational Review and Correction of Errors](/manager-book#engineering-excellence-operational-review-and-correction-of-errors)
+  - [Data Driven - Customer and Business Metric Reviews](/manager-book#data-driven-customer-and-business-metric-reviews)
+  - [Continuous Improvement - Retrospectives](/manager-book#continuous-improvement-retrospectives)
+  - [Team Participation and Feedback - Surveys and Polls](/manager-book#team-participation-and-feedback-surveys-and-polls)
+  - [Quality and Technical Growth Design+Arch Reviews](/manager-book#quality-and-technical-growth-designarch-reviews)
+  - [Code reviews](/manager-book#code-reviews)
+- [Planning, Roadmaps and Resource Allocation](/manager-book#planning-roadmaps-and-resource-allocation)
+  - [Start with why, end with who: The execution order framework](/manager-book#start-with-why-end-with-who-the-execution-order-framework)
+  - [Define success: Setting effective goals](/manager-book#define-success-setting-effective-goals)
+  - [Build the roadmap: Planning and sequencing](/manager-book#build-the-roadmap-planning-and-sequencing)
+  - [Create the schedule: Timeline and milestones](/manager-book#create-the-schedule-timeline-and-milestones)
+  - [Allocate resources: Matching people and projects](/manager-book#allocate-resources-matching-people-and-projects)
+  - [Understand roles: The road building analogy](/manager-book#understand-roles-the-road-building-analogy)
+  - [Prioritize work: Making tough trade-offs](/manager-book#prioritize-work-making-tough-trade-offs)
+  - [Estimate effort: Using SWAG and T-shirt sizing](/manager-book#estimate-effort-using-swag-and-t-shirt-sizing)
+  - [Be wary the planning trap](/manager-book#be-wary-the-planning-trap)
+- [Hiring](/manager-book#hiring)
+  - [What are you looking for when you recruit](/manager-book#what-are-you-looking-for-when-you-recruit)
+  - [Do they prefer to hire only experienced folks](/manager-book#do-they-prefer-to-hire-only-experienced-folks)
+  - [Are they more comfortable with generalists or specialists](/manager-book#are-they-more-comfortable-with-generalists-or-specialists)
+  - [How do you think about hiring](/manager-book#how-do-you-think-about-hiring)
+  - [How do you think about the hiring funnel](/manager-book#how-do-you-think-about-the-hiring-funnel)
+  - [What about structured vs free form interview loops](/manager-book#what-about-structured-vs-free-form-interview-loops)
+  - [What are better kinds of interviews](/manager-book#what-are-better-kinds-of-interviews)
+  - [What do you do when someone says they are quitting](/manager-book#what-do-you-do-when-someone-says-they-are-quitting)
+  - [What is a tribe?](/manager-book#what-is-a-tribe)
+- [Performance Management](/manager-book#performance-management)
+  - [Performance Reviews: Calibrations PSC, OLR, Connections](/manager-book#performance-reviews-calibrations-psc-olr-connections)
+  - [Translating Performance Ratings Between Companies](/manager-book#translating-performance-ratings-between-companies)
+  - [Best Practices For Performance Reviews](/manager-book#best-practices-for-performance-reviews)
+  - [The pain and the suffering of performance reviews](/manager-book#the-pain-and-the-suffering-of-performance-reviews)
+  - [Some definitions for low performers](/manager-book#some-definitions-for-low-performers)
+  - [Performance Management for low performers](/manager-book#performance-management-for-low-performers)
+  - [The types of URA](/manager-book#the-types-of-ura)
+  - [URA doesn't mean the person sucks - it means they are not compatible.](/manager-book#ura-doesnt-mean-the-person-sucks-it-means-they-are-not-compatible)
+  - [What if a URA isn't "fair"?](/manager-book#what-if-a-ura-isnt-fair)
+  - [The who and how of performance management](/manager-book#the-who-and-how-of-performance-management)
+  - [How do you coach employee back to success](/manager-book#how-do-you-coach-employee-back-to-success)
+  - [How do handle poor communication, ESL, ineffective communication in some modalities](/manager-book#how-do-handle-poor-communication-esl-ineffective-communication-in-some-modalities)
+- [Cross Org Influence](/manager-book#cross-org-influence)
+  - [How do you think about escalations?](/manager-book#how-do-you-think-about-escalations)
+- [Team Insecurity](/manager-book#team-insecurity)
+  - [How do you nudge engineers who won't ask you for help?](/manager-book#how-do-you-nudge-engineers-who-wont-ask-you-for-help)
+  - [Everyone wants to feel supported](/manager-book#everyone-wants-to-feel-supported)
+  - [Maintain perspective](/manager-book#maintain-perspective)
+- [Charters, Re-orgs and Bootstrapping](/manager-book#charters-re-orgs-and-bootstrapping)
+  - [The genesis: When you start from scratch](/manager-book#the-genesis-when-you-start-from-scratch)
+  - [The split: When a team outgrows a manager](/manager-book#the-split-when-a-team-outgrows-a-manager)
+  - [The merge: When a manager leaves](/manager-book#the-merge-when-a-manager-leaves)
+  - [The flip: When charter changes](/manager-book#the-flip-when-charter-changes)
+  - [The Double down vs Pivot: When there is insufficient progress](/manager-book#the-double-down-vs-pivot-when-there-is-insufficient-progress)
+  - [Telling the team about reorg/recharter](/manager-book#telling-the-team-about-reorgrecharter)
+  - [How to handle Layoffs](/manager-book#how-to-handle-layoffs)
+- [Personal Motivations](/manager-book#personal-motivations)
+  - [Why do you find management attractive](/manager-book#why-do-you-find-management-attractive)
+  - [What is your dream job](/manager-book#what-is-your-dream-job)
+  - [What are your career aspirations](/manager-book#what-are-your-career-aspirations)
+  - [Why do you think you're a good coach](/manager-book#why-do-you-think-youre-a-good-coach)
+  - [Why do you prefer being a manager to an IC](/manager-book#why-do-you-prefer-being-a-manager-to-an-ic)
+- [Questions managers get](/manager-book#questions-managers-get)
+  - [What does a manager do in a day](/manager-book#what-does-a-manager-do-in-a-day)
+  - [What's the best/worst part of your job](/manager-book#whats-the-bestworst-part-of-your-job)
+  - [How do you get anything done with all of those meetings](/manager-book#how-do-you-get-anything-done-with-all-of-those-meetings)
+  - [What do you think developers do](/manager-book#what-do-you-think-developers-do)
+  - [What can engineers do to make manager's jobs easier](/manager-book#what-can-engineers-do-to-make-managers-jobs-easier)
+  - [Why do managers always say coding is part of their job but we all know it isn't](/manager-book#why-do-managers-always-say-coding-is-part-of-their-job-but-we-all-know-it-isnt)
+- [Product Development and Product Management](/manager-book#product-development-and-product-management)
+- [Business Acumen and Strategy](/manager-book#business-acumen-and-strategy)
+- [Appendix](/manager-book#appendix)
 - [The Whole Manager Book](#the-whole-manager-book)
 - [Leadership Principles by Company](#leadership-principles-by-company)
   - [Google's Project Oxygen](#googles-project-oxygen)
@@ -23,11 +151,8 @@ A hodgepodge of additional resources for the manager book.
 - [Misc Topics](#misc-topics)
   - [A few Igorisms](#a-few-igorisms)
   - [Igor's career](#igors-career)
-    - [Joining Facebook](#joining-facebook)
-    - [Joining Amazon](#joining-amazon)
-    - [Dream Job](#dream-job)
   - [Laws to remember](#laws-to-remember)
-  - [Who has the monkey - fanstic advice from 1974!](#who-has-the-monkey---fanstic-advice-from-1974)
+  - [Who has the monkey - fanstic advice from 1974!](#who-has-the-monkey-fanstic-advice-from-1974)
   - [The Resilience of Alien Chess](#the-resilience-of-alien-chess)
   - [How you need to communicate differently](#how-you-need-to-communicate-differently)
 - [Analogies to be fleshed out](#analogies-to-be-fleshed-out)
@@ -38,7 +163,6 @@ A hodgepodge of additional resources for the manager book.
   - [New hire perspective is like landing a plane](#new-hire-perspective-is-like-landing-a-plane)
 - [Other Resources](#other-resources)
   - [Fun Cartoons](#fun-cartoons)
-    - [Poor motivational choices](#poor-motivational-choices)
   - [Great Videos](#great-videos)
   - [Great Posts and Blogs](#great-posts-and-blogs)
   - [Great books](#great-books)