# Why I Wrote a Personal README (and Why You Should Too)

- Link: https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/
- Published: 2025-03-06T14:18:35-06:00
- Author: jeffpaul

I value transparency, collaboration, and clarity whether that’s working with colleagues,
contributors in the WordPress community, or clients.  But one thing has become clear
over time: everyone works differently, and understanding those differences upfront
makes for smoother, more effective collaboration.  Enter the Personal README.

Inspired by [Luc Levesque](https://coda.io/@luc-levesque/blueprint-for-leaders-managers-communicate-your-quirks/my-blueprint-9),
[Roy Rapoport](https://bit.ly/roy-latest-readme), and [18F’s guide on Personal READMEs](https://18f.gsa.gov/2020/03/05/readmes-for-you-and-me/),
I put together my own as a way to share how I work, communicate, and approach leadership.
It’s a snapshot of my work style, values, and expectations, both for myself and 
for those working with me.

???? **Check it out here: [jeffpaul.com/readme/](https://jeffpaul.com/readme/)**

### Why Write a Personal README?

A Personal README isn’t a set of hard rules, it’s a tool to set expectations, remove
ambiguity, and help others understand how to best work with you.  It can cover things
like:

 * Your working hours and communication preferences
 * Your approach to meetings and collaboration
 * What makes you excited (and what chafes you or makes you grumpy)
 * How you give and receive feedback

By being upfront about these things, you can reduce friction and make it easier 
for colleagues to engage effectively.  It also helps new team members ramp up faster,
since they don’t have to guess what works best.

### My Challenge to You

If you haven’t written a Personal README yet, I highly encourage you to give it 
a shot!  Start with something simple and iterate over time.  Ask yourself:

 * What’s important to me in how I collaborate?
 * What do I expect from my teammates?
 * How do I like to communicate and make decisions?

And if you do create one, share it!  Put it in your profile on social networks and
communication platforms as well as your personal website (you own your own content
right?!), basically wherever people can easily find it.  The more we normalize transparent
communication, the easier it becomes to work effectively together.

If you already have a Personal README, I’d love to see it!  Drop a link in the comments
or tag me on [Bluesky](https://bsky.app/profile/jeffpaul.com) / [Mastodon](https://mastodon.social/@jeffpaul)/
[LinkedIn](https://www.linkedin.com/in/jeffpaul/) or wherever we connect.

Let’s make working together easier. ????

### Share this:

 * [  Bluesky ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=bluesky)
 * [  Mastodon ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=mastodon)
 * [  LinkedIn ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=linkedin)
 * [  Print ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/#print?share=print)
 * [  Email ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?subject=%5BShared%20Post%5D%20Why%20I%20Wrote%20a%20Personal%20README%20%28and%20Why%20You%20Should%20Too%29&body=https%3A%2F%2Fjeffpaul.com%2F2025%2F03%2Fwhy-i-wrote-a-personal-readme-and-why-you-should-too%2F&share=email)
 * [More](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/#)

 * [  Facebook ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=facebook)
 * [  Nextdoor ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=nextdoor)
 * [  Pinterest ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=pinterest)
 * [  Reddit ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=reddit)
 * [  Telegram ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=telegram)
 * [  Tumblr ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=tumblr)
 * [  WhatsApp ](https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/?share=jetpack-whatsapp)

### Like this:

Like Loading…

## Comments

### By: Cullen Whitmore

- Link: https://jeffpaul.com/2025/03/why-i-wrote-a-personal-readme-and-why-you-should-too/#comment-2795
- Published: 2025-03-06T18:47:12-06:00

I love this! I have a “Work with me” that might get renamed to “README” tonight.

Loading...
