From 39ae0fbb2ba3a7d12ad65036dbcd5456e90b2d97 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Wed, 29 Jan 2020 11:07:34 -0300 Subject: [PATCH] Added the whole structure --- things-i-learnt/src/SUMMARY.md | 96 ++++++++++++++++++- .../src/personal/bad-code-defense.md | 1 + things-i-learnt/src/personal/blogging.md | 1 + things-i-learnt/src/personal/coc.md | 1 + things-i-learnt/src/personal/fixable.md | 1 + things-i-learnt/src/personal/hero-syndrome.md | 1 + things-i-learnt/src/personal/index.md | 1 + .../src/personal/learn-about-yourself.md | 1 + .../src/personal/microaggressions.md | 1 + things-i-learnt/src/personal/not-done.md | 1 + things-i-learnt/src/personal/own-your-shit.md | 1 + things-i-learnt/src/personal/people-care.md | 1 + things-i-learnt/src/personal/post-solution.md | 1 + things-i-learnt/src/personal/quit.md | 1 + .../src/personal/responsible-code.md | 1 + things-i-learnt/src/personal/say-no.md | 1 + things-i-learnt/src/personal/small-world.md | 1 + things-i-learnt/src/personal/specialists.md | 1 + .../src/personal/stupid-bugs-list.md | 1 + .../src/personal/things-i-dont-know.md | 1 + things-i-learnt/src/personal/time-to-stop.md | 1 + things-i-learnt/src/personal/time.md | 1 + things-i-learnt/src/personal/toxic-people.md | 1 + .../src/personal/watch-reactions.md | 1 + .../src/programming/before/cognitive-cost.md | 1 + .../src/programming/before/data-flow.md | 1 + .../src/programming/before/debuggers.md | 1 + .../before/functional-programming.md | 1 + .../src/programming/{ => before}/gherkin.md | 0 .../before/magical-number-seven.md | 1 + .../{ => before}/patterns-not-solutions.md | 0 .../programming/{ => before}/spec-first.md | 0 .../{ => before}/steps-as-comments.md | 0 .../before/understand-shortcuts.md | 1 + .../src/programming/before/users.md | 1 + things-i-learnt/src/programming/coding.md | 1 + .../programming/coding/boolean-parameters.md | 1 + .../src/programming/coding/crash-it.md | 1 + .../src/programming/coding/data-types.md | 1 + .../src/programming/coding/future-trashing.md | 1 + .../src/programming/coding/handle-it.md | 1 + .../programming/coding/interface-changes.md | 1 + .../src/programming/coding/optimization.md | 1 + .../src/programming/coding/outside-project.md | 1 + .../programming/coding/permanent-solution.md | 1 + .../src/programming/coding/resist-easy.md | 1 + .../src/programming/coding/run-locally.md | 1 + .../src/programming/coding/start-stupid.md | 1 + .../src/programming/coding/throw-away.md | 1 + .../src/programming/coding/units.md | 1 + .../src/programming/coding/use-structures.md | 1 + .../src/programming/coding/use-timezones.md | 1 + .../src/programming/coding/use-utf8.md | 1 + .../src/programming/documentation.md | 1 + .../programming/documentation/document-and.md | 1 + .../documentation/document-is-contract.md | 1 + .../programming/documentation/document-it.md | 1 + .../documentation/languages-docs.md | 1 + .../src/programming/organization.md | 1 + .../src/programming/organization/libraries.md | 1 + .../programming/organization/paper-notes.md | 1 + .../organization/project-organization.md | 1 + things-i-learnt/src/programming/running.md | 1 + .../programming/running/add-then-remove.md | 1 + .../running/app-composition-stupid.md | 1 + .../running/application-composition.md | 1 + .../running/command-line-options.md | 1 + .../src/programming/running/config-file.md | 1 + .../src/programming/running/log-events.md | 1 + .../src/programming/running/monitoring.md | 1 + .../src/programming/running/transparent.md | 1 + .../src/programming/source-control.md | 1 + .../programming/source-control/always-vcs.md | 1 + .../src/programming/source-control/gerrit.md | 1 + .../programming/source-control/git-flow.md | 1 + .../source-control/one-change-commit.md | 1 + things-i-learnt/src/programming/testing.md | 1 + .../programming/testing/integration-tests.md | 1 + .../programming/testing/languages-tests.md | 1 + .../src/programming/testing/tests-apis.md | 1 + .../programming/testing/tests-dead-code.md | 1 + .../testing/tests-in-the-command-line.md | 1 + things-i-learnt/src/teams/cargo-cult.md | 1 + things-i-learnt/src/teams/code-formatters.md | 1 + .../src/teams/code-reviews-style.md | 1 + things-i-learnt/src/teams/code-style.md | 1 + .../src/teams/google-code-style.md | 1 + things-i-learnt/src/teams/hero-projects.md | 1 + things-i-learnt/src/teams/index.md | 1 + .../src/teams/languages-are-more.md | 1 + .../src/teams/right-tool-agenda.md | 1 + .../src/teams/right-tool-obvious.md | 1 + things-i-learnt/src/teams/team-discussion.md | 1 + 93 files changed, 180 insertions(+), 4 deletions(-) create mode 100644 things-i-learnt/src/personal/bad-code-defense.md create mode 100644 things-i-learnt/src/personal/blogging.md create mode 100644 things-i-learnt/src/personal/coc.md create mode 100644 things-i-learnt/src/personal/fixable.md create mode 100644 things-i-learnt/src/personal/hero-syndrome.md create mode 100644 things-i-learnt/src/personal/index.md create mode 100644 things-i-learnt/src/personal/learn-about-yourself.md create mode 100644 things-i-learnt/src/personal/microaggressions.md create mode 100644 things-i-learnt/src/personal/not-done.md create mode 100644 things-i-learnt/src/personal/own-your-shit.md create mode 100644 things-i-learnt/src/personal/people-care.md create mode 100644 things-i-learnt/src/personal/post-solution.md create mode 100644 things-i-learnt/src/personal/quit.md create mode 100644 things-i-learnt/src/personal/responsible-code.md create mode 100644 things-i-learnt/src/personal/say-no.md create mode 100644 things-i-learnt/src/personal/small-world.md create mode 100644 things-i-learnt/src/personal/specialists.md create mode 100644 things-i-learnt/src/personal/stupid-bugs-list.md create mode 100644 things-i-learnt/src/personal/things-i-dont-know.md create mode 100644 things-i-learnt/src/personal/time-to-stop.md create mode 100644 things-i-learnt/src/personal/time.md create mode 100644 things-i-learnt/src/personal/toxic-people.md create mode 100644 things-i-learnt/src/personal/watch-reactions.md create mode 100644 things-i-learnt/src/programming/before/cognitive-cost.md create mode 100644 things-i-learnt/src/programming/before/data-flow.md create mode 100644 things-i-learnt/src/programming/before/debuggers.md create mode 100644 things-i-learnt/src/programming/before/functional-programming.md rename things-i-learnt/src/programming/{ => before}/gherkin.md (100%) create mode 100644 things-i-learnt/src/programming/before/magical-number-seven.md rename things-i-learnt/src/programming/{ => before}/patterns-not-solutions.md (100%) rename things-i-learnt/src/programming/{ => before}/spec-first.md (100%) rename things-i-learnt/src/programming/{ => before}/steps-as-comments.md (100%) create mode 100644 things-i-learnt/src/programming/before/understand-shortcuts.md create mode 100644 things-i-learnt/src/programming/before/users.md create mode 100644 things-i-learnt/src/programming/coding.md create mode 100644 things-i-learnt/src/programming/coding/boolean-parameters.md create mode 100644 things-i-learnt/src/programming/coding/crash-it.md create mode 100644 things-i-learnt/src/programming/coding/data-types.md create mode 100644 things-i-learnt/src/programming/coding/future-trashing.md create mode 100644 things-i-learnt/src/programming/coding/handle-it.md create mode 100644 things-i-learnt/src/programming/coding/interface-changes.md create mode 100644 things-i-learnt/src/programming/coding/optimization.md create mode 100644 things-i-learnt/src/programming/coding/outside-project.md create mode 100644 things-i-learnt/src/programming/coding/permanent-solution.md create mode 100644 things-i-learnt/src/programming/coding/resist-easy.md create mode 100644 things-i-learnt/src/programming/coding/run-locally.md create mode 100644 things-i-learnt/src/programming/coding/start-stupid.md create mode 100644 things-i-learnt/src/programming/coding/throw-away.md create mode 100644 things-i-learnt/src/programming/coding/units.md create mode 100644 things-i-learnt/src/programming/coding/use-structures.md create mode 100644 things-i-learnt/src/programming/coding/use-timezones.md create mode 100644 things-i-learnt/src/programming/coding/use-utf8.md create mode 100644 things-i-learnt/src/programming/documentation.md create mode 100644 things-i-learnt/src/programming/documentation/document-and.md create mode 100644 things-i-learnt/src/programming/documentation/document-is-contract.md create mode 100644 things-i-learnt/src/programming/documentation/document-it.md create mode 100644 things-i-learnt/src/programming/documentation/languages-docs.md create mode 100644 things-i-learnt/src/programming/organization.md create mode 100644 things-i-learnt/src/programming/organization/libraries.md create mode 100644 things-i-learnt/src/programming/organization/paper-notes.md create mode 100644 things-i-learnt/src/programming/organization/project-organization.md create mode 100644 things-i-learnt/src/programming/running.md create mode 100644 things-i-learnt/src/programming/running/add-then-remove.md create mode 100644 things-i-learnt/src/programming/running/app-composition-stupid.md create mode 100644 things-i-learnt/src/programming/running/application-composition.md create mode 100644 things-i-learnt/src/programming/running/command-line-options.md create mode 100644 things-i-learnt/src/programming/running/config-file.md create mode 100644 things-i-learnt/src/programming/running/log-events.md create mode 100644 things-i-learnt/src/programming/running/monitoring.md create mode 100644 things-i-learnt/src/programming/running/transparent.md create mode 100644 things-i-learnt/src/programming/source-control.md create mode 100644 things-i-learnt/src/programming/source-control/always-vcs.md create mode 100644 things-i-learnt/src/programming/source-control/gerrit.md create mode 100644 things-i-learnt/src/programming/source-control/git-flow.md create mode 100644 things-i-learnt/src/programming/source-control/one-change-commit.md create mode 100644 things-i-learnt/src/programming/testing.md create mode 100644 things-i-learnt/src/programming/testing/integration-tests.md create mode 100644 things-i-learnt/src/programming/testing/languages-tests.md create mode 100644 things-i-learnt/src/programming/testing/tests-apis.md create mode 100644 things-i-learnt/src/programming/testing/tests-dead-code.md create mode 100644 things-i-learnt/src/programming/testing/tests-in-the-command-line.md create mode 100644 things-i-learnt/src/teams/cargo-cult.md create mode 100644 things-i-learnt/src/teams/code-formatters.md create mode 100644 things-i-learnt/src/teams/code-reviews-style.md create mode 100644 things-i-learnt/src/teams/code-style.md create mode 100644 things-i-learnt/src/teams/google-code-style.md create mode 100644 things-i-learnt/src/teams/hero-projects.md create mode 100644 things-i-learnt/src/teams/index.md create mode 100644 things-i-learnt/src/teams/languages-are-more.md create mode 100644 things-i-learnt/src/teams/right-tool-agenda.md create mode 100644 things-i-learnt/src/teams/right-tool-obvious.md create mode 100644 things-i-learnt/src/teams/team-discussion.md diff --git a/things-i-learnt/src/SUMMARY.md b/things-i-learnt/src/SUMMARY.md index f1e1be2..9197bb6 100644 --- a/things-i-learnt/src/SUMMARY.md +++ b/things-i-learnt/src/SUMMARY.md @@ -4,7 +4,95 @@ - [Disclaimer](./disclaimer.md) - [Programming](./programming/index.md) - [Before You Start Writing Code](./programming/before.md) - - [Spec First, Then Code](./programming/spec-first.md) - - [Write Steps as Comments](./programming/steps-as-comments.md) - - [Gherkin Is Your Friend to Understand Expectations](./programming/gherkin.md) - - [Design Patters Are Used to Name Solution, Not Find Them](./programming/patterns-not-solutions.md) + - [Spec First, Then Code](./programming/before/spec-first.md) + - [Write Steps as Comments](./programming/before/steps-as-comments.md) + - [Gherkin Is Your Friend to Understand Expectations](./programming/before/gherkin.md) + - [Design Patters Are Used to Name Solution, Not Find Them](./programming/before/patterns-not-solutions.md) + - [Thinking Data Flow Beats Patterns](./programming/before/data-flow.md) + - [The Magic Number Seven, Plus Or Minus Two](./programming/before/magical-number-seven.md) + - [Cognitive Cost Is The Readability Killer](./programming/before/cognitive-cost.md) + - [Learn The Basics of Functional Programming](./programming/before/functional-programming.md) + - [Shortcuts Are Nice, But Only In The Short Run](./programming/before/understand-shortcuts.md) + - [Debuggers Are Overrated](./programming/before/debuggers.md) + - [Think About The Users](./programming/before/users.md) + - [Testing Software](./programming/testing.md) + - [Unit Tests Are Good, Integration Tests Are Gooder](./programming/testing/integration-tests.md) + - [Testing Every Function Creates Dead Code](./programming/testing/tests-dead-code.md) + - [Tests Make Better APIs](./programming/testing/tests-apis.md) + - [Make Tests That You Know How To Run On The Command Line](./programming/testing/tests-in-the-command-line.md) + - [Good Languages Come With Tests](./programming/testing/languages-tests.md) + - [Documenting your code](./programming/documentation.md) + - [Documentation Is A Love Letter To Your Future Self](./programming/documentation/document-it.md) + - [The Function Documentation Is Its Contract](./programming/documentation/document-is-contract.md) + - [If A Function Description Includes An "And", It's Wrong](./programming/documentation/document-and.md) + - [Good Languages Come With Integrated Documentation](./programming/documentation/languages-docs.md) + - [Source Control](./programming/source-control.md) + - [Always Use A Version Control System](./programming/source-control/always-vcs.md) + - [One Commit Per Change](./programming/source-control/one-change-commit.md) + - [Gerrit Is A Mistake](./programming/source-control/gerrit.md) + - [Git-Flow Is The Way To Go](./programming/source-control/git-flow.md) + - [Project Organization](./programming/organization.md) + - [Organize Your Code by Data/Type, Not Functionality](./programming/organization/project-organization.md) + - [Create Libraries](./programming/organization/libraries.md) + - [Paper Notes Are Actually Helpful](./programming/organization/paper-notes.md) + - [Writing code](./programming/coding.md) + - [Be Ready To Throw Your Code Away](./programming/coding/throw-away.md) + - [Future Thinking Is Future Trashing](./programming/coding/future-trashing.md) + - [Don't Use Booleans As Parameters](./programming/coding/boolean-parameters.md) + - [Beware of Interface Changes](./programming/coding/interface-changes.md) + - [It's Better To Let The Application Crash Than Do Nothing](./programming/coding/crash-it.md) + - [If You Know How To Handle It, Handle It](./programming/coding/handle-it.md) + - [Types Say What Your Data Is](./programming/coding/data-types.md) + - [If Your Data Has a Schema, Use a Structure](./programming/coding/use-structures.md) + - [Don't Mess With Things Outside Your Project](./programming/coding/outside-project.md) + - [Resist The Temptation Of Easy](./programming/coding/resist-easy.md) + - [Start Stupid](./programming/coding/start-stupid.md) + - [Always Use Timezones With Your Dates](./programming/coding/use-timezones.md) + - [Always Use UTF-8 For Your Strings](./programming/coding/use-utf8.md) + - [Optimization Is For Compilers](./programming/coding/optimization.md) + - [Units Makes Things Clear](./programming/coding/units.md) + - [If It Doesn't Run On Your Computer, You Have A Problem](./programming/coding/run-locally.md) + - [Nothing More Permanent Than A Temporary Solution](./programming/coding/permanent-solution.md) + - [Making Things Go](./programming/running.md) + - [The Config File Is Friend](./programming/running/config-file.md) + - [Command Line Options Are Weird, But Helpful](./programming/running/command-line-options.md) + - [Not Just Function Composition, But Application Composition](./programming/running/application-composition.md) + - [Even for Application Composition, Start Stupid](./programming/running/app-composition-stupid.md) + - [Logs Are For Events, Not User Interface](./programming/running/log-events.md) + - [Be Transparent With The User](./programming/running/transparent.md) + - [One Version To Add, One Version To Remove](./programming/running/add-then-remove.md) + - [Learn To Monitor](./programming/running/monitoring.md) +- [Community/Teams](./teams/index.md) + - [A Language Is Much More Than A Language](./teams/languages-are-more.md) + - [Understand And Stay Away From Cargo Cult](./teams/cargo-cult.md) + - ["Right Tool For The Job" Is Just To Push An Agenda](./teams/right-tool-agenda.md) + - [The Right Tool Is More Obvious Than You Think](./teams/right-tool-obvious.md) + - [Code Reviews Are Not For Style](./teams/code-reviews-style.md) + - [Code Formatting Tools Are Ok, But No Silver Bullet](./teams/code-formatters.md) + - [Code Style: Follow It](./teams/code-style.md) + - [... Unless That Code Style Is The Google Code Style](./teams/google-code-style.md) + - [Hero Projects: You'll Have To Do It Yourself](./teams/hero-projects.md) + - [Global Changes Must Be Discussed With The Whole Team First](./teams/team-discussion.md) +- [Personal](./personal/index.md) + - [Companies Look For Specialists But Keep Generalists Longer](./personal/specialists.md) + - [Keep A List of Stupid Bugs That Took More Than 1 Hour To Solve](./personal/stupid-bugs-list.md) + - [When It's Time to Stop, It's Time To Stop](./personal/time-to-stop.md) + - [Code of Conduct Protect YOU, Not THEM](./personal/coc.md) + - [Learn To Say No](./personal/say-no.md) + - [Take Responsibility For The Use Of Your Code](./personal/responsible-code.md) + - [Don't Tell It's Done When It's Not](./personal/not-done.md) + - [People Get Upset About Code And Architecture Quality 'Cause They Care](./personal/people-care.md) + - [You'll Learn About Yourself The Hard Way](./personal/learn-about-yourself.md) + - [Pay Attention On How People React To You](./personal/watch-reactions.md) + - [Don't Confuse Hero Project With Hero Syndrome](./personal/hero-syndrome.md) + - [Beware of Toxic People](./personal/toxic-people.md) + - [Beware of Microaggressions](./personal/microaggressions.md) + - [Toxic/Aggressive People Are Not Fixable -- Unless It's You](./personal/fixable.md) + - [Realize When It's Time To Quit](./personal/quit.md) + - [I.T. World Is Really Small](./personal/small-world.md) + - [Blogging About Your Stupid Solution Is Still Better Than Being Quiet](./personal/blogging.md) + - [Don't Hide Your Stupid Solution](./personal/post-solution.md) + - [Keep A List of Things I Don't Know](./personal/things-i-dont-know.md) + - [You Always Have The Time](./personal/time.md) + - [Own Your Shit](./personal/own-your-shit.md) + - [Don't Defend Bad Code](./personal/bad-code-defense.md) diff --git a/things-i-learnt/src/personal/bad-code-defense.md b/things-i-learnt/src/personal/bad-code-defense.md new file mode 100644 index 0000000..5a8bf1e --- /dev/null +++ b/things-i-learnt/src/personal/bad-code-defense.md @@ -0,0 +1 @@ +# Don't Defend Bad Code diff --git a/things-i-learnt/src/personal/blogging.md b/things-i-learnt/src/personal/blogging.md new file mode 100644 index 0000000..035723d --- /dev/null +++ b/things-i-learnt/src/personal/blogging.md @@ -0,0 +1 @@ +# Blogging About Your Stupid Solution Is Still Better Than Being Quiet diff --git a/things-i-learnt/src/personal/coc.md b/things-i-learnt/src/personal/coc.md new file mode 100644 index 0000000..afef92c --- /dev/null +++ b/things-i-learnt/src/personal/coc.md @@ -0,0 +1 @@ +# Code of Conduct Protect YOU, Not THEM diff --git a/things-i-learnt/src/personal/fixable.md b/things-i-learnt/src/personal/fixable.md new file mode 100644 index 0000000..43a3191 --- /dev/null +++ b/things-i-learnt/src/personal/fixable.md @@ -0,0 +1 @@ +# Toxic/Aggressive People Are Not Fixable -- Unless It's You diff --git a/things-i-learnt/src/personal/hero-syndrome.md b/things-i-learnt/src/personal/hero-syndrome.md new file mode 100644 index 0000000..84601e0 --- /dev/null +++ b/things-i-learnt/src/personal/hero-syndrome.md @@ -0,0 +1 @@ +# Don't Confuse Hero Project With Hero Syndrome diff --git a/things-i-learnt/src/personal/index.md b/things-i-learnt/src/personal/index.md new file mode 100644 index 0000000..3d4bcd7 --- /dev/null +++ b/things-i-learnt/src/personal/index.md @@ -0,0 +1 @@ +# Personal diff --git a/things-i-learnt/src/personal/learn-about-yourself.md b/things-i-learnt/src/personal/learn-about-yourself.md new file mode 100644 index 0000000..f6bfa9b --- /dev/null +++ b/things-i-learnt/src/personal/learn-about-yourself.md @@ -0,0 +1 @@ +# You'll Learn About Yourself The Hard Way diff --git a/things-i-learnt/src/personal/microaggressions.md b/things-i-learnt/src/personal/microaggressions.md new file mode 100644 index 0000000..101d6d0 --- /dev/null +++ b/things-i-learnt/src/personal/microaggressions.md @@ -0,0 +1 @@ +# Beware of Microaggressions diff --git a/things-i-learnt/src/personal/not-done.md b/things-i-learnt/src/personal/not-done.md new file mode 100644 index 0000000..d846141 --- /dev/null +++ b/things-i-learnt/src/personal/not-done.md @@ -0,0 +1 @@ +# Don't Tell It's Done When It's Not diff --git a/things-i-learnt/src/personal/own-your-shit.md b/things-i-learnt/src/personal/own-your-shit.md new file mode 100644 index 0000000..032602b --- /dev/null +++ b/things-i-learnt/src/personal/own-your-shit.md @@ -0,0 +1 @@ +# Own Your Shit diff --git a/things-i-learnt/src/personal/people-care.md b/things-i-learnt/src/personal/people-care.md new file mode 100644 index 0000000..5e040db --- /dev/null +++ b/things-i-learnt/src/personal/people-care.md @@ -0,0 +1 @@ +# People Get Upset About Code And Architecture Quality 'Cause They Care diff --git a/things-i-learnt/src/personal/post-solution.md b/things-i-learnt/src/personal/post-solution.md new file mode 100644 index 0000000..3d3ee8b --- /dev/null +++ b/things-i-learnt/src/personal/post-solution.md @@ -0,0 +1 @@ +# Don't Hide Your Stupid Solution diff --git a/things-i-learnt/src/personal/quit.md b/things-i-learnt/src/personal/quit.md new file mode 100644 index 0000000..6d776cf --- /dev/null +++ b/things-i-learnt/src/personal/quit.md @@ -0,0 +1 @@ +# Realize When It's Time To Quit diff --git a/things-i-learnt/src/personal/responsible-code.md b/things-i-learnt/src/personal/responsible-code.md new file mode 100644 index 0000000..78749c8 --- /dev/null +++ b/things-i-learnt/src/personal/responsible-code.md @@ -0,0 +1 @@ +# Take Responsibility For The Use Of Your Code diff --git a/things-i-learnt/src/personal/say-no.md b/things-i-learnt/src/personal/say-no.md new file mode 100644 index 0000000..89f2a15 --- /dev/null +++ b/things-i-learnt/src/personal/say-no.md @@ -0,0 +1 @@ +# Learn To Say No diff --git a/things-i-learnt/src/personal/small-world.md b/things-i-learnt/src/personal/small-world.md new file mode 100644 index 0000000..ec13d59 --- /dev/null +++ b/things-i-learnt/src/personal/small-world.md @@ -0,0 +1 @@ +# I.T. World Is Really Small diff --git a/things-i-learnt/src/personal/specialists.md b/things-i-learnt/src/personal/specialists.md new file mode 100644 index 0000000..1a0e35c --- /dev/null +++ b/things-i-learnt/src/personal/specialists.md @@ -0,0 +1 @@ +# Companies Look For Specialists But Keep Generalists Longer diff --git a/things-i-learnt/src/personal/stupid-bugs-list.md b/things-i-learnt/src/personal/stupid-bugs-list.md new file mode 100644 index 0000000..e7303fc --- /dev/null +++ b/things-i-learnt/src/personal/stupid-bugs-list.md @@ -0,0 +1 @@ +# Keep A List of Stupid Bugs That Took More Than 1 Hour To Solve diff --git a/things-i-learnt/src/personal/things-i-dont-know.md b/things-i-learnt/src/personal/things-i-dont-know.md new file mode 100644 index 0000000..b9d35cc --- /dev/null +++ b/things-i-learnt/src/personal/things-i-dont-know.md @@ -0,0 +1 @@ +# Keep A List of Things I Don't Know diff --git a/things-i-learnt/src/personal/time-to-stop.md b/things-i-learnt/src/personal/time-to-stop.md new file mode 100644 index 0000000..8d2bed9 --- /dev/null +++ b/things-i-learnt/src/personal/time-to-stop.md @@ -0,0 +1 @@ +# When It's Time to Stop, It's Time To Stop diff --git a/things-i-learnt/src/personal/time.md b/things-i-learnt/src/personal/time.md new file mode 100644 index 0000000..fdc2b73 --- /dev/null +++ b/things-i-learnt/src/personal/time.md @@ -0,0 +1 @@ +# You Always Have The Time diff --git a/things-i-learnt/src/personal/toxic-people.md b/things-i-learnt/src/personal/toxic-people.md new file mode 100644 index 0000000..4dc5879 --- /dev/null +++ b/things-i-learnt/src/personal/toxic-people.md @@ -0,0 +1 @@ +# Beware of Toxic People diff --git a/things-i-learnt/src/personal/watch-reactions.md b/things-i-learnt/src/personal/watch-reactions.md new file mode 100644 index 0000000..1ea45ba --- /dev/null +++ b/things-i-learnt/src/personal/watch-reactions.md @@ -0,0 +1 @@ +# Pay Attention On How People React To You diff --git a/things-i-learnt/src/programming/before/cognitive-cost.md b/things-i-learnt/src/programming/before/cognitive-cost.md new file mode 100644 index 0000000..e5eff72 --- /dev/null +++ b/things-i-learnt/src/programming/before/cognitive-cost.md @@ -0,0 +1 @@ +# Cognitive Cost Is The Readability Killer diff --git a/things-i-learnt/src/programming/before/data-flow.md b/things-i-learnt/src/programming/before/data-flow.md new file mode 100644 index 0000000..c7355d9 --- /dev/null +++ b/things-i-learnt/src/programming/before/data-flow.md @@ -0,0 +1 @@ +# Thinking Data Flow Beats Patterns diff --git a/things-i-learnt/src/programming/before/debuggers.md b/things-i-learnt/src/programming/before/debuggers.md new file mode 100644 index 0000000..a3a27b5 --- /dev/null +++ b/things-i-learnt/src/programming/before/debuggers.md @@ -0,0 +1 @@ +# Debuggers Are Overrated diff --git a/things-i-learnt/src/programming/before/functional-programming.md b/things-i-learnt/src/programming/before/functional-programming.md new file mode 100644 index 0000000..96df208 --- /dev/null +++ b/things-i-learnt/src/programming/before/functional-programming.md @@ -0,0 +1 @@ +# Learn The Basics of Functional Programming diff --git a/things-i-learnt/src/programming/gherkin.md b/things-i-learnt/src/programming/before/gherkin.md similarity index 100% rename from things-i-learnt/src/programming/gherkin.md rename to things-i-learnt/src/programming/before/gherkin.md diff --git a/things-i-learnt/src/programming/before/magical-number-seven.md b/things-i-learnt/src/programming/before/magical-number-seven.md new file mode 100644 index 0000000..a1bc8e5 --- /dev/null +++ b/things-i-learnt/src/programming/before/magical-number-seven.md @@ -0,0 +1 @@ +# The Magic Number Seven, Plus Or Minus Two diff --git a/things-i-learnt/src/programming/patterns-not-solutions.md b/things-i-learnt/src/programming/before/patterns-not-solutions.md similarity index 100% rename from things-i-learnt/src/programming/patterns-not-solutions.md rename to things-i-learnt/src/programming/before/patterns-not-solutions.md diff --git a/things-i-learnt/src/programming/spec-first.md b/things-i-learnt/src/programming/before/spec-first.md similarity index 100% rename from things-i-learnt/src/programming/spec-first.md rename to things-i-learnt/src/programming/before/spec-first.md diff --git a/things-i-learnt/src/programming/steps-as-comments.md b/things-i-learnt/src/programming/before/steps-as-comments.md similarity index 100% rename from things-i-learnt/src/programming/steps-as-comments.md rename to things-i-learnt/src/programming/before/steps-as-comments.md diff --git a/things-i-learnt/src/programming/before/understand-shortcuts.md b/things-i-learnt/src/programming/before/understand-shortcuts.md new file mode 100644 index 0000000..7b25c4c --- /dev/null +++ b/things-i-learnt/src/programming/before/understand-shortcuts.md @@ -0,0 +1 @@ +# Shortcuts Are Nice, But Only In The Short Run diff --git a/things-i-learnt/src/programming/before/users.md b/things-i-learnt/src/programming/before/users.md new file mode 100644 index 0000000..c64af66 --- /dev/null +++ b/things-i-learnt/src/programming/before/users.md @@ -0,0 +1 @@ +# Think About The Users diff --git a/things-i-learnt/src/programming/coding.md b/things-i-learnt/src/programming/coding.md new file mode 100644 index 0000000..819e264 --- /dev/null +++ b/things-i-learnt/src/programming/coding.md @@ -0,0 +1 @@ +# Writing code diff --git a/things-i-learnt/src/programming/coding/boolean-parameters.md b/things-i-learnt/src/programming/coding/boolean-parameters.md new file mode 100644 index 0000000..4514bee --- /dev/null +++ b/things-i-learnt/src/programming/coding/boolean-parameters.md @@ -0,0 +1 @@ +# Don't Use Booleans As Parameters diff --git a/things-i-learnt/src/programming/coding/crash-it.md b/things-i-learnt/src/programming/coding/crash-it.md new file mode 100644 index 0000000..dcd649d --- /dev/null +++ b/things-i-learnt/src/programming/coding/crash-it.md @@ -0,0 +1 @@ +# It's Better To Let The Application Crash Than Do Nothing diff --git a/things-i-learnt/src/programming/coding/data-types.md b/things-i-learnt/src/programming/coding/data-types.md new file mode 100644 index 0000000..29fcf88 --- /dev/null +++ b/things-i-learnt/src/programming/coding/data-types.md @@ -0,0 +1 @@ +# Types Say What Your Data Is diff --git a/things-i-learnt/src/programming/coding/future-trashing.md b/things-i-learnt/src/programming/coding/future-trashing.md new file mode 100644 index 0000000..353760d --- /dev/null +++ b/things-i-learnt/src/programming/coding/future-trashing.md @@ -0,0 +1 @@ +# Future Thinking Is Future Trashing diff --git a/things-i-learnt/src/programming/coding/handle-it.md b/things-i-learnt/src/programming/coding/handle-it.md new file mode 100644 index 0000000..2b5df2d --- /dev/null +++ b/things-i-learnt/src/programming/coding/handle-it.md @@ -0,0 +1 @@ +# If You Know How To Handle It, Handle It diff --git a/things-i-learnt/src/programming/coding/interface-changes.md b/things-i-learnt/src/programming/coding/interface-changes.md new file mode 100644 index 0000000..2208896 --- /dev/null +++ b/things-i-learnt/src/programming/coding/interface-changes.md @@ -0,0 +1 @@ +# Beware of Interface Changes diff --git a/things-i-learnt/src/programming/coding/optimization.md b/things-i-learnt/src/programming/coding/optimization.md new file mode 100644 index 0000000..ab7d49d --- /dev/null +++ b/things-i-learnt/src/programming/coding/optimization.md @@ -0,0 +1 @@ +# Optimization Is For Compilers diff --git a/things-i-learnt/src/programming/coding/outside-project.md b/things-i-learnt/src/programming/coding/outside-project.md new file mode 100644 index 0000000..13f2af4 --- /dev/null +++ b/things-i-learnt/src/programming/coding/outside-project.md @@ -0,0 +1 @@ +# Don't Mess With Things Outside Your Project diff --git a/things-i-learnt/src/programming/coding/permanent-solution.md b/things-i-learnt/src/programming/coding/permanent-solution.md new file mode 100644 index 0000000..9612b47 --- /dev/null +++ b/things-i-learnt/src/programming/coding/permanent-solution.md @@ -0,0 +1 @@ +# Nothing More Permanent Than A Temporary Solution diff --git a/things-i-learnt/src/programming/coding/resist-easy.md b/things-i-learnt/src/programming/coding/resist-easy.md new file mode 100644 index 0000000..6993cd0 --- /dev/null +++ b/things-i-learnt/src/programming/coding/resist-easy.md @@ -0,0 +1 @@ +# Resist The Temptation Of Easy diff --git a/things-i-learnt/src/programming/coding/run-locally.md b/things-i-learnt/src/programming/coding/run-locally.md new file mode 100644 index 0000000..c0aa3d4 --- /dev/null +++ b/things-i-learnt/src/programming/coding/run-locally.md @@ -0,0 +1 @@ +# If It Doesn't Run On Your Computer, You Have A Problem diff --git a/things-i-learnt/src/programming/coding/start-stupid.md b/things-i-learnt/src/programming/coding/start-stupid.md new file mode 100644 index 0000000..8fdcda7 --- /dev/null +++ b/things-i-learnt/src/programming/coding/start-stupid.md @@ -0,0 +1 @@ +# Start Stupid diff --git a/things-i-learnt/src/programming/coding/throw-away.md b/things-i-learnt/src/programming/coding/throw-away.md new file mode 100644 index 0000000..707f670 --- /dev/null +++ b/things-i-learnt/src/programming/coding/throw-away.md @@ -0,0 +1 @@ +# Be Ready To Throw Your Code Away diff --git a/things-i-learnt/src/programming/coding/units.md b/things-i-learnt/src/programming/coding/units.md new file mode 100644 index 0000000..5a5ea10 --- /dev/null +++ b/things-i-learnt/src/programming/coding/units.md @@ -0,0 +1 @@ +# Units Makes Things Clear diff --git a/things-i-learnt/src/programming/coding/use-structures.md b/things-i-learnt/src/programming/coding/use-structures.md new file mode 100644 index 0000000..8ac3601 --- /dev/null +++ b/things-i-learnt/src/programming/coding/use-structures.md @@ -0,0 +1 @@ +# If Your Data Has a Schema, Use a Structure diff --git a/things-i-learnt/src/programming/coding/use-timezones.md b/things-i-learnt/src/programming/coding/use-timezones.md new file mode 100644 index 0000000..9dab464 --- /dev/null +++ b/things-i-learnt/src/programming/coding/use-timezones.md @@ -0,0 +1 @@ +# Always Use Timezones With Your Dates diff --git a/things-i-learnt/src/programming/coding/use-utf8.md b/things-i-learnt/src/programming/coding/use-utf8.md new file mode 100644 index 0000000..894599b --- /dev/null +++ b/things-i-learnt/src/programming/coding/use-utf8.md @@ -0,0 +1 @@ +# Always Use UTF-8 For Your Strings diff --git a/things-i-learnt/src/programming/documentation.md b/things-i-learnt/src/programming/documentation.md new file mode 100644 index 0000000..5f1f07b --- /dev/null +++ b/things-i-learnt/src/programming/documentation.md @@ -0,0 +1 @@ +# Documenting your code diff --git a/things-i-learnt/src/programming/documentation/document-and.md b/things-i-learnt/src/programming/documentation/document-and.md new file mode 100644 index 0000000..199eda7 --- /dev/null +++ b/things-i-learnt/src/programming/documentation/document-and.md @@ -0,0 +1 @@ +# If A Function Description Includes An "And", It's Wrong diff --git a/things-i-learnt/src/programming/documentation/document-is-contract.md b/things-i-learnt/src/programming/documentation/document-is-contract.md new file mode 100644 index 0000000..62b0f7b --- /dev/null +++ b/things-i-learnt/src/programming/documentation/document-is-contract.md @@ -0,0 +1 @@ +# The Function Documentation Is Its Contract diff --git a/things-i-learnt/src/programming/documentation/document-it.md b/things-i-learnt/src/programming/documentation/document-it.md new file mode 100644 index 0000000..24e464d --- /dev/null +++ b/things-i-learnt/src/programming/documentation/document-it.md @@ -0,0 +1 @@ +# Documentation Is A Love Letter To Your Future Self diff --git a/things-i-learnt/src/programming/documentation/languages-docs.md b/things-i-learnt/src/programming/documentation/languages-docs.md new file mode 100644 index 0000000..f3e204d --- /dev/null +++ b/things-i-learnt/src/programming/documentation/languages-docs.md @@ -0,0 +1 @@ +# Good Languages Come With Integrated Documentation diff --git a/things-i-learnt/src/programming/organization.md b/things-i-learnt/src/programming/organization.md new file mode 100644 index 0000000..a508d47 --- /dev/null +++ b/things-i-learnt/src/programming/organization.md @@ -0,0 +1 @@ +# Project Organization diff --git a/things-i-learnt/src/programming/organization/libraries.md b/things-i-learnt/src/programming/organization/libraries.md new file mode 100644 index 0000000..12eea55 --- /dev/null +++ b/things-i-learnt/src/programming/organization/libraries.md @@ -0,0 +1 @@ +# Create Libraries diff --git a/things-i-learnt/src/programming/organization/paper-notes.md b/things-i-learnt/src/programming/organization/paper-notes.md new file mode 100644 index 0000000..b20513d --- /dev/null +++ b/things-i-learnt/src/programming/organization/paper-notes.md @@ -0,0 +1 @@ +# Paper Notes Are Actually Helpful diff --git a/things-i-learnt/src/programming/organization/project-organization.md b/things-i-learnt/src/programming/organization/project-organization.md new file mode 100644 index 0000000..22f60b0 --- /dev/null +++ b/things-i-learnt/src/programming/organization/project-organization.md @@ -0,0 +1 @@ +# Organize Your Code by Data/Type, Not Functionality diff --git a/things-i-learnt/src/programming/running.md b/things-i-learnt/src/programming/running.md new file mode 100644 index 0000000..4f19928 --- /dev/null +++ b/things-i-learnt/src/programming/running.md @@ -0,0 +1 @@ +# Making Things Go diff --git a/things-i-learnt/src/programming/running/add-then-remove.md b/things-i-learnt/src/programming/running/add-then-remove.md new file mode 100644 index 0000000..b6cbfe5 --- /dev/null +++ b/things-i-learnt/src/programming/running/add-then-remove.md @@ -0,0 +1 @@ +# One Version To Add, One Version To Remove diff --git a/things-i-learnt/src/programming/running/app-composition-stupid.md b/things-i-learnt/src/programming/running/app-composition-stupid.md new file mode 100644 index 0000000..4155abd --- /dev/null +++ b/things-i-learnt/src/programming/running/app-composition-stupid.md @@ -0,0 +1 @@ +# Even for Application Composition, Start Stupid diff --git a/things-i-learnt/src/programming/running/application-composition.md b/things-i-learnt/src/programming/running/application-composition.md new file mode 100644 index 0000000..7382f97 --- /dev/null +++ b/things-i-learnt/src/programming/running/application-composition.md @@ -0,0 +1 @@ +# Not Just Function Composition, But Application Composition diff --git a/things-i-learnt/src/programming/running/command-line-options.md b/things-i-learnt/src/programming/running/command-line-options.md new file mode 100644 index 0000000..70e74c6 --- /dev/null +++ b/things-i-learnt/src/programming/running/command-line-options.md @@ -0,0 +1 @@ +# Command Line Options Are Weird, But Helpful diff --git a/things-i-learnt/src/programming/running/config-file.md b/things-i-learnt/src/programming/running/config-file.md new file mode 100644 index 0000000..66945fa --- /dev/null +++ b/things-i-learnt/src/programming/running/config-file.md @@ -0,0 +1 @@ +# The Config File Is Friend diff --git a/things-i-learnt/src/programming/running/log-events.md b/things-i-learnt/src/programming/running/log-events.md new file mode 100644 index 0000000..67437f5 --- /dev/null +++ b/things-i-learnt/src/programming/running/log-events.md @@ -0,0 +1 @@ +# Logs Are For Events, Not User Interface diff --git a/things-i-learnt/src/programming/running/monitoring.md b/things-i-learnt/src/programming/running/monitoring.md new file mode 100644 index 0000000..1e601e9 --- /dev/null +++ b/things-i-learnt/src/programming/running/monitoring.md @@ -0,0 +1 @@ +# Learn To Monitor diff --git a/things-i-learnt/src/programming/running/transparent.md b/things-i-learnt/src/programming/running/transparent.md new file mode 100644 index 0000000..1cda33e --- /dev/null +++ b/things-i-learnt/src/programming/running/transparent.md @@ -0,0 +1 @@ +# Be Transparent With The User diff --git a/things-i-learnt/src/programming/source-control.md b/things-i-learnt/src/programming/source-control.md new file mode 100644 index 0000000..5b34595 --- /dev/null +++ b/things-i-learnt/src/programming/source-control.md @@ -0,0 +1 @@ +# Source Control diff --git a/things-i-learnt/src/programming/source-control/always-vcs.md b/things-i-learnt/src/programming/source-control/always-vcs.md new file mode 100644 index 0000000..499fd05 --- /dev/null +++ b/things-i-learnt/src/programming/source-control/always-vcs.md @@ -0,0 +1 @@ +# Always Use A Version Control System diff --git a/things-i-learnt/src/programming/source-control/gerrit.md b/things-i-learnt/src/programming/source-control/gerrit.md new file mode 100644 index 0000000..c64b355 --- /dev/null +++ b/things-i-learnt/src/programming/source-control/gerrit.md @@ -0,0 +1 @@ +# Gerrit Is A Mistake diff --git a/things-i-learnt/src/programming/source-control/git-flow.md b/things-i-learnt/src/programming/source-control/git-flow.md new file mode 100644 index 0000000..08bd4b9 --- /dev/null +++ b/things-i-learnt/src/programming/source-control/git-flow.md @@ -0,0 +1 @@ +# Git-Flow Is The Way To Go diff --git a/things-i-learnt/src/programming/source-control/one-change-commit.md b/things-i-learnt/src/programming/source-control/one-change-commit.md new file mode 100644 index 0000000..4548367 --- /dev/null +++ b/things-i-learnt/src/programming/source-control/one-change-commit.md @@ -0,0 +1 @@ +# One Commit Per Change diff --git a/things-i-learnt/src/programming/testing.md b/things-i-learnt/src/programming/testing.md new file mode 100644 index 0000000..0d3d208 --- /dev/null +++ b/things-i-learnt/src/programming/testing.md @@ -0,0 +1 @@ +# Testing Software diff --git a/things-i-learnt/src/programming/testing/integration-tests.md b/things-i-learnt/src/programming/testing/integration-tests.md new file mode 100644 index 0000000..0654ef7 --- /dev/null +++ b/things-i-learnt/src/programming/testing/integration-tests.md @@ -0,0 +1 @@ +# Unit Tests Are Good, Integration Tests Are Gooder diff --git a/things-i-learnt/src/programming/testing/languages-tests.md b/things-i-learnt/src/programming/testing/languages-tests.md new file mode 100644 index 0000000..6485d5f --- /dev/null +++ b/things-i-learnt/src/programming/testing/languages-tests.md @@ -0,0 +1 @@ +# Good Languages Come With Tests diff --git a/things-i-learnt/src/programming/testing/tests-apis.md b/things-i-learnt/src/programming/testing/tests-apis.md new file mode 100644 index 0000000..b058d92 --- /dev/null +++ b/things-i-learnt/src/programming/testing/tests-apis.md @@ -0,0 +1 @@ +# Tests Make Better APIs diff --git a/things-i-learnt/src/programming/testing/tests-dead-code.md b/things-i-learnt/src/programming/testing/tests-dead-code.md new file mode 100644 index 0000000..d56ea4f --- /dev/null +++ b/things-i-learnt/src/programming/testing/tests-dead-code.md @@ -0,0 +1 @@ +# Testing Every Function Creates Dead Code diff --git a/things-i-learnt/src/programming/testing/tests-in-the-command-line.md b/things-i-learnt/src/programming/testing/tests-in-the-command-line.md new file mode 100644 index 0000000..0ed2ebd --- /dev/null +++ b/things-i-learnt/src/programming/testing/tests-in-the-command-line.md @@ -0,0 +1 @@ +# Make Tests That You Know How To Run On The Command Line diff --git a/things-i-learnt/src/teams/cargo-cult.md b/things-i-learnt/src/teams/cargo-cult.md new file mode 100644 index 0000000..a681704 --- /dev/null +++ b/things-i-learnt/src/teams/cargo-cult.md @@ -0,0 +1 @@ +# Understand And Stay Away From Cargo Cult diff --git a/things-i-learnt/src/teams/code-formatters.md b/things-i-learnt/src/teams/code-formatters.md new file mode 100644 index 0000000..32ff705 --- /dev/null +++ b/things-i-learnt/src/teams/code-formatters.md @@ -0,0 +1 @@ +# Code Formatting Tools Are Ok, But No Silver Bullet diff --git a/things-i-learnt/src/teams/code-reviews-style.md b/things-i-learnt/src/teams/code-reviews-style.md new file mode 100644 index 0000000..95ae562 --- /dev/null +++ b/things-i-learnt/src/teams/code-reviews-style.md @@ -0,0 +1 @@ +# Code Reviews Are Not For Style diff --git a/things-i-learnt/src/teams/code-style.md b/things-i-learnt/src/teams/code-style.md new file mode 100644 index 0000000..e09ac4a --- /dev/null +++ b/things-i-learnt/src/teams/code-style.md @@ -0,0 +1 @@ +# Code Style: Follow It diff --git a/things-i-learnt/src/teams/google-code-style.md b/things-i-learnt/src/teams/google-code-style.md new file mode 100644 index 0000000..362b676 --- /dev/null +++ b/things-i-learnt/src/teams/google-code-style.md @@ -0,0 +1 @@ +# ... Unless That Code Style Is The Google Code Style diff --git a/things-i-learnt/src/teams/hero-projects.md b/things-i-learnt/src/teams/hero-projects.md new file mode 100644 index 0000000..ec836ba --- /dev/null +++ b/things-i-learnt/src/teams/hero-projects.md @@ -0,0 +1 @@ +# Hero Projects: You'll Have To Do It Yourself diff --git a/things-i-learnt/src/teams/index.md b/things-i-learnt/src/teams/index.md new file mode 100644 index 0000000..cd5f674 --- /dev/null +++ b/things-i-learnt/src/teams/index.md @@ -0,0 +1 @@ +# Community/Teams diff --git a/things-i-learnt/src/teams/languages-are-more.md b/things-i-learnt/src/teams/languages-are-more.md new file mode 100644 index 0000000..3c2e4a3 --- /dev/null +++ b/things-i-learnt/src/teams/languages-are-more.md @@ -0,0 +1 @@ +# A Language Is Much More Than A Language diff --git a/things-i-learnt/src/teams/right-tool-agenda.md b/things-i-learnt/src/teams/right-tool-agenda.md new file mode 100644 index 0000000..59ca552 --- /dev/null +++ b/things-i-learnt/src/teams/right-tool-agenda.md @@ -0,0 +1 @@ +# "Right Tool For The Job" Is Just To Push An Agenda diff --git a/things-i-learnt/src/teams/right-tool-obvious.md b/things-i-learnt/src/teams/right-tool-obvious.md new file mode 100644 index 0000000..6244cf7 --- /dev/null +++ b/things-i-learnt/src/teams/right-tool-obvious.md @@ -0,0 +1 @@ +# The Right Tool Is More Obvious Than You Think diff --git a/things-i-learnt/src/teams/team-discussion.md b/things-i-learnt/src/teams/team-discussion.md new file mode 100644 index 0000000..913077c --- /dev/null +++ b/things-i-learnt/src/teams/team-discussion.md @@ -0,0 +1 @@ +# Global Changes Must Be Discussed With The Whole Team First