daviddoji/professional-programming
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: markdownlint errors besides blockquotes

Browse Source
This commit is contained in:
J. Degand 2025-01-24 19:38:49 +00:00 committed by Charles-Axel Dein
parent 0178b501bb
commit 051480288f
1 changed files with 68 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
README.md
View File

@ -1,6 +1,6 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update --> <!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
## Table of Contents # Table of Contents
- [Professional Programming - about this list](#professional-programming---about-this-list) - [Professional Programming - about this list](#professional-programming---about-this-list)
- [Principles](#principles) - [Principles](#principles)
@ -451,6 +451,7 @@ More specific topics:
Dan Heller, Building a Career in Software Dan Heller, Building a Career in Software
> I had learned already never to empty the well of my writing, but always to stop when there was still something there in the deep part of the well, and let it refill at night from the springs that fed it. -- Ernest Hemingway > I had learned already never to empty the well of my writing, but always to stop when there was still something there in the deep part of the well, and let it refill at night from the springs that fed it. -- Ernest Hemingway
- [The Grug Brained Developer](https://grugbrain.dev): habits of self-aware programmer. Like Tao of Programming, different style. - [The Grug Brained Developer](https://grugbrain.dev): habits of self-aware programmer. Like Tao of Programming, different style.
> Good judgment comes from experience. > Good judgment comes from experience.
@ -634,7 +635,6 @@ About senior engineers:
- [No code reviews by default](https://www.raycast.com/blog/no-code-reviews-by-default/) - [No code reviews by default](https://www.raycast.com/blog/no-code-reviews-by-default/)
- Responsibility over convention - Responsibility over convention
### Coding & code quality ### Coding & code quality
- [Write code that is easy to delete, not easy to extend](http://programmingisterrible.com/post/139222674273/write-code-that-is-easy-to-delete-not-easy-to) - [Write code that is easy to delete, not easy to extend](http://programmingisterrible.com/post/139222674273/write-code-that-is-easy-to-delete-not-easy-to)
@ -776,7 +776,7 @@ Also see the Incident Response section in this doc
- [Debugging zine](https://jvns.ca/debugging-zine.pdf), Julian Evans - [Debugging zine](https://jvns.ca/debugging-zine.pdf), Julian Evans
- [If you understand a bug, you can fix it](https://wizardzines.com/comics/understand-can-fix/) - [If you understand a bug, you can fix it](https://wizardzines.com/comics/understand-can-fix/)
- [The Thirty Minute Rule](https://daniel.feldroy.com/posts/thirty-minute-rule): if anyone gets stuck on something for more than 30 minutes, they should ask for help - [The Thirty Minute Rule](https://daniel.feldroy.com/posts/thirty-minute-rule): if anyone gets stuck on something for more than 30 minutes, they should ask for help
- [How to create a Minimal, Reproducible Example ](https://stackoverflow.com/help/minimal-reproducible-example), Stack Overflow - [How to create a Minimal, Reproducible Example](https://stackoverflow.com/help/minimal-reproducible-example), Stack Overflow
- [Some ways to get better at debugging](https://jvns.ca/blog/2022/08/30/a-way-to-categorize-debugging-skills/), Julia Evans - [Some ways to get better at debugging](https://jvns.ca/blog/2022/08/30/a-way-to-categorize-debugging-skills/), Julia Evans
- Learn the codebase - Learn the codebase
- Learn the system (e.g., HTTP stack, database transactions) - Learn the system (e.g., HTTP stack, database transactions)
@ -1330,7 +1330,7 @@ About flashcards:
- Fernando Borretti, [Effective Spaced Repetition](https://borretti.me/article/effective-spaced-repetition) - Fernando Borretti, [Effective Spaced Repetition](https://borretti.me/article/effective-spaced-repetition)
- [Anki-fy Your Life](https://abouttolearn.substack.com/p/anki-fy-your-life) gets into why it makes sense to invest in your memory. - [Anki-fy Your Life](https://abouttolearn.substack.com/p/anki-fy-your-life) gets into why it makes sense to invest in your memory.
About Zettelkasten and PKM (personal knowledge management): see [Personal knowledge management](#personal-knowledge-management) About Zettelkasten and PKM (personal knowledge management): see [Personal knowledge management](#personal-knowledge-management-pkm)
Richard Feynman's Learning Strategy: Richard Feynman's Learning Strategy:
@ -1413,7 +1413,7 @@ Richard Feynman's Learning Strategy:
### Observability (monitoring, logging, exception handling) ### Observability (monitoring, logging, exception handling)
*See also: [Site Reliability Engineering (SRE)](#site-reliability-engineering-sre)* _See also: [Site Reliability Engineering (SRE)](#site-reliability-engineering-sre)_
#### Logging #### Logging
@ -1566,7 +1566,6 @@ See the [Product management section on my entrepreneurship-resources list of res
- Checkout this newsletter produced by Posthog: [Product for Engineers](https://newsletter.posthog.com/) - Checkout this newsletter produced by Posthog: [Product for Engineers](https://newsletter.posthog.com/)
### Project management ### Project management
See the [Project management section on my engineering-management list of resources](https://github.com/charlax/engineering-management#project-management). See the [Project management section on my engineering-management list of resources](https://github.com/charlax/engineering-management#project-management).
@ -1623,7 +1622,6 @@ JavaScript is such a pervasive language that it's almost required learning.
- [30 Days of JavaScript](https://github.com/Asabeneh/30-Days-Of-JavaScript): 30 days of JavaScript programming challenge is a step-by-step guide to learn JavaScript programming language in 30 days. - [30 Days of JavaScript](https://github.com/Asabeneh/30-Days-Of-JavaScript): 30 days of JavaScript programming challenge is a step-by-step guide to learn JavaScript programming language in 30 days.
- [Unleash JavaScript's Potential with Functional Programming](https://janhesters.com/blog/unleash-javascripts-potential-with-functional-programming) - [Unleash JavaScript's Potential with Functional Programming](https://janhesters.com/blog/unleash-javascripts-potential-with-functional-programming)
#### Garbage collection #### Garbage collection
- [A Guide to the Go Garbage Collector](https://go.dev/doc/gc-guide): a very insightful guide about Go's GC - [A Guide to the Go Garbage Collector](https://go.dev/doc/gc-guide): a very insightful guide about Go's GC
@ -1741,7 +1739,7 @@ JavaScript is such a pervasive language that it's almost required learning.
### Reliability ### Reliability
*See also [System architecture](#system-architecture)* **See also [System architecture](#system-architecture)**
Books: Books:
@ -1752,7 +1750,6 @@ Quotes:
> Quality is a snapshot at the start of life and reliability is a motion picture of the day-by-day operation. > Quality is a snapshot at the start of life and reliability is a motion picture of the day-by-day operation.
> – [NIST](https://www.itl.nist.gov/div898/handbook/apr/section1/apr111.htm) > – [NIST](https://www.itl.nist.gov/div898/handbook/apr/section1/apr111.htm)
> Reliability is the one feature every customer users. -- An auth0 SRE. > Reliability is the one feature every customer users. -- An auth0 SRE.
Articles: Articles:
@ -1900,7 +1897,7 @@ List of resources:
### System architecture ### System architecture
*See also [Reliability](#system-architecture), [Scalability](#scalability)* **See also [Reliability](#system-architecture), [Scalability](#scalability)**
Reading lists: Reading lists:
@ -1970,7 +1967,7 @@ Articles:
### Scalability ### Scalability
*See also: [Reliability](#reliability), [System architecture](#system-architecture)* **See also: [Reliability](#reliability), [System architecture](#system-architecture)**
- [Scalable web architecture and distributed systems](http://www.aosabook.org/en/distsys.html) - [Scalable web architecture and distributed systems](http://www.aosabook.org/en/distsys.html)
- 📖 [Scalability Rules: 50 Principles for Scaling Web Sites](https://smile.amazon.com/Scalability-Rules-Principles-Scaling-Sites/dp/013443160X) ([presentation](http://www.slideshare.net/cyrilwang/scalability-rules)) - 📖 [Scalability Rules: 50 Principles for Scaling Web Sites](https://smile.amazon.com/Scalability-Rules-Principles-Scaling-Sites/dp/013443160X) ([presentation](http://www.slideshare.net/cyrilwang/scalability-rules))
@ -1978,7 +1975,7 @@ Articles:
### Site Reliability Engineering (SRE) ### Site Reliability Engineering (SRE)
*See: [Reliability](#reliability)* **See: [Reliability](#reliability)**
### Technical debt ### Technical debt
@ -2177,11 +2174,11 @@ Guides & classes about technical writing:
## Resources & inspiration for presentations ## Resources & inspiration for presentations
- https://twitter.com/devops_borat - <https://twitter.com/devops_borat>
- https://speakerdeck.com/ - <https://speakerdeck.com/>
- Dilbert - Dilbert
- Calvin & Hobbes ([search engine](http://michaelyingling.com/random/calvin_and_hobbes/)) - Calvin & Hobbes ([search engine](http://michaelyingling.com/random/calvin_and_hobbes/))
- https://twitter.com/_workchronicles - <https://twitter.com/_workchronicles>
## Keeping up-to-date ## Keeping up-to-date