Hacker News new | past | comments | ask | show | jobs | submit login
What Is a Personal User Manual? (2022) (futureforum.com)
75 points by taubek 10 months ago | hide | past | favorite | 69 comments



These were popular at my workplace maybe seven years ago, and while I was into the idea at first, IMO it was impractical most of the time. Turns out it's a pretty unreasonable burden to place on people that they should read and follow instructions in a document in order to communicate with someone and to personalize their work approach for every person they interact with.

The main context these make sense in is when written by a manager (or maaybe by a direct report for their manager). They can be useful to establish expectations for a team around things like "is it ok to message me on the weekend" and "here's what you should have prepared for our 1:1s".


I find that I never know what to write about myself in these. I had to make one for work also a few years ago for similar reasons to you. But when I would read it I could see it represented a part of me, but it's hard to say "talk to me like this" because it depends on what the subject is and who the person is. I found it was interesting to do as a team building exercise because we all did them together and read them to each other as teams but I never found myself or others getting back to it. And at some point I would've preferred if the document disappeared because years later some new joiners would read it and think something I wrote in 15mins in a workshop 6 years ago still represented who I was at the present time.


> it depends on what the subject is and who the person is

bingo.

> because years later some new joiners would read it and think something I wrote in 15mins in a workshop 6 years ago still represented who I was at the present time.

As with any other documentation, you need to spend time keeping it up to date. If you'd upgraded some libraries and added new ones, but still had docs you gave to new team members referencing the outdated libraries... how productive could they possibly be?


Maybe they only make sense, when they are really simple like:

"is it ok to message me on the weekend"

Mine would be:

"message anytime, don't expect response outside work hours, but can happen"

"only call in emergencies"


I mean, this should just be the worldwide default.

We should not be normalizing a culture of working outside of working hours.


There is also that I have different expectations for different types of work relationships.

I don't want a manager pinging me 7 times a day with questions. But I am OK with a coworker messaging me 15 times about their progress on something we're trying to get done together for that manager. One disrupts the maker cycle and one is two makers making together in the same cycle.


+1, rules of engagement make sense at the team level, not the individual level.


> "here's what you should have prepared for our 1:1s"

Tangentially, I'd like to survey attitudes about this kind of 1:1. I'm of the opinion that my 1:1 with my manager is my time to discuss my thoughts and needs. If a manager is assigning me homework so I can "come prepared" for yet another status update, they can sacrifice their time to make that meeting happen.


Almost like we need API's for interpersonal communication, which, as long as we all adhere to them, remove many of the difficulties.


Some modern-day teams will do a simplified team building exercise where they determine what "colour" people are, idk which one it is exactly, might be Hartman Personality Profile


This is honestly for a subset of the population the needs special catering. I can see things like disabilities, pronouns, and trigger words going into something like this.

I also can see this a hinderence to our general interpersonal communication.


one might also position it this way: “most people probably don’t feel the need for a document like this because they believe their preferences are the default for most people.”


Oh no, not this again.

I'm not sure I could muster the arrogance to write such a document about myself... and then expect people to read it. The suggested examples of what the document could contain are bizarre and yet also weirdly simple & obvious...

"I am a sponge. I’ll take more content earlier rather than a formal presentation"

"Please give me the bad news before I hear it from somewhere else"

"Be direct. Tell me what you need and when you need it."


"I'd rather get on with some actual work than create a stupid document about me to pander to management's latest whim-du-jour."

I guess it hasn't occurred to them that most introverts would hate having to write about themselves in this way, and a reasonable subset wouldn't be interested in reading what the extroverts have to say about themselves either.

A far better approach is to not have any preconceived ideas about your colleagues, and discover how you interact best as and when the need arises. There isn't a one-size-fits-all approach for how different people should interact with an individual.


And worse yet, the kind of person who needs to read a document like this is the kind of person who treats people poorly as a rule, either through malice or ignorance.

So it stresses out a lot of people, and doesn't actually help anyone.


> A far better approach is to not have any preconceived ideas about your colleagues, and discover how you interact best as and when the need arises. There isn't a one-size-fits-all approach for how different people should interact with an individual.

Sounds very extroverted and without any issues in bothering other people /s

Honestly, a humble "README" for the person is something I'm coming to appreciate more and more, at least so long as it's humble and not condescending to people.

Especially as someone both introverted, and as it turns out, on the autistic spectrum (nice bomb to find out after 34 years :V)


From the title, I expected "here's all the stuff I need to run my life in one handy place" - passwords, bank account details, when my car insurance is due, etc etc. Part calendar, part password safe.

This was... not that.


So basically ISO 9000/9001 for your life.

I think most people would probably run in terror at the suggestion.


"I have no hobbies listed on the list of hobbies approved by HR."

"I do not sponsor HR gym bunnies swimming for charity."

"I am not interested in cycle-to-work tax relief schemes."

"I will not eat vegan food just because HR found our that it was the new thing they should beat employees with."

"Use clear, well structured English to communicate with me."

"Incentivising me with free beers at the manager's favourite pub is not going to work."


Yeah, those 3 bullets will better serve as part of a team charter, rather than one individual's preferences in contrast to how everyone else communicates.


Unfortunately, driving and enforcing ("softly" or "hard") a team charter is harder than publishing a short README telling how to best communicate with you.


So you expect persons to write a personal user manual. Have you seen what happens to normal docs?

And who has this complete picture of oneself that is not obscured by the lies that we tell about ourselves? The self-deception and the imposter syndromes that we foster?

I guess these manuals will be outdated sooner than the regular docs - and if your staff has time on their hands to write and maintain them, you might be running an adult daycare center!


Suspect the real purpose is a form of personal marketing. It's going to end up chock full of resume-style "I am a bright and receptive person, able to communicate well with people at all levels. I use my own initiative and I am flexible in my approach to work duties" boilerplate.

Anyone who provides useful information, eg "I'm at my best in the mornings, try to catch me then, oh and dumb down the technical language a bit" is, frankly, a moron.


Why is anyone honestly providing useful information a moron?

At least if the "PUM" is in private context.


As mentioned, people have an incentive to lie. Who's going to write "I just fake being online the first and last 2 hours every day, so don't bother" or "I never understood our database" or "I get emotional all the time" or "I reverse manage"?

People will say they welcome direct feedback and would love to have focus time, what else?


> At least if the "PUM" is in private context.

Surely it would available, at an absolute minimum, to anyone within the org who is going to communicate with you, otherwise what's the point?


By "private" I meant "not on public internet and in view of automated systems and their recruiter lackeys"[1] ;)

[1] I've met good recruiters, but sometimes it feels like automated systems are taking over and running roughshod over people, including recruiters.


This looks to me as the idiocy of the pronouns, on steroids.

They both are based on the wrong assumption that people have to ask your opinion before contacting you, while communication has always been based on shared standards.

Normality exists. It's not something to tend to, but it exists and must be recognized and respected, and everybody is expected to do their share in conforming to normality.


I’d say pronouns are a pretty different thing than this.

> everybody is expected to do their share in conforming to normality.

This is a regressive approach to the world. There are lots of past normals that are pretty terrible. I’m glad that our history is filled with people who were strong enough to be nonconformists, so that I can thrive in a world relatively free of religious persecution, racial profiling, classism, etc. And I am more than happy to stand up to regressive norms of today on behalf of other marginalized groups.


What is next? Everyone sending forms to everyone to fill and sign before communication


Any normality that is not backed by violence is respectable.


It's absurd to expect people to adjust their communication timing based on each contact's preferences, when the recipient can simply adjust their communication devices to block and filter messages/calls according to their preferences. That way each person only has to do the work once, compared to having to remember each of maybe dozens or hundreds of people's preferences.


Further, my team’s mail list spans people working from IST through PT (13.5 hours). If everyone works a local 9-5*, there is no moment when mail to that list (or a post to our slack channel) won’t hit someone “off hours”.

* Or anything even close to that…

Throttle on input.


It feels clear from the subtext that the value in such a thing would be in communicating where you are generally weak, ie, I don't take criticism well, or I can be pedantic and sometimes all you need to do is ACK my feedback, etc. The examples lack any sort of vulnerability though, they don't introduce any genuine flaws (some of the 'how best to work with me' tips would simply be construed as straightforward praise coming from anyone else).

Its just such a weird intersection. First, you need people that are aware of their interpersonal pain points and for those problems to be deep rooted enough that an onboarding doc makes sense. Then, you need those same people to accept being emotionally vulnerable in a space others are going to use for blatant self promotion - in this case just being ignorant of your own flaws counts because you will write some dumb shit like 'I am data driven show me the facts' but in reality you will base decisions on your gut and a spreadsheet you threw together.


The weird thing about documenting own weaknesses is that once you have identified them they technically have no reason to even exist (other than your laziness), much less to be grounds for requirements you would force on others.

You can learn from my behavior that I don’t take criticism well and then tone it down; however, if I am self-aware enough to know and state explicitly that I don’t take criticism well, to then demand you to change your ways (and get offended if you don’t) seems just… childish, for lack of a better word.

Does this demonstrate my own ignorance about some aspect of psychology?


Mmm somewhat, yes. Recognizing a flaw/a need for a change and enacting it is not instantaneous under the best of circumstances.


It’s hard to see acknowledging and publicly documenting a flaw as anything but a request to help with its elimination, and eliminating a flaw is impossible without intentionally creating the triggering condition.


Anything other than "I am responsive to all communication at all times and happy to switch focus to whatever you need me to do at a moment's notice, boss" is going to come back and bite you in the ass, isn't it.

The way to deal with unwanted interruptions is to ignore them and then later claim you were so busy you didn't notice. No downside to that. (Headphones help with this if they've forced you back into an office.)


This would be better suited for volunteer situations like unpaid open source work, where people have their personalities out in the open and don't conform to externally imposed expectations.

If you're employed in a company or organization, you have to conform your personality to their manual, modulo reasonable wiggle room. That's it.

Nobody has the time to read N different manuals, and then ponder over interpretations in order to decide on how to proceed.


> If you're employed in a company or organization, you have to conform your personality to their manual, modulo reasonable wiggle room. That's it.

Quite right! We have enough abstractions on reality already.


That sounds like a solid framework. Similarly, there's 'Six Thinking Hats' (1985) [1], which is another tool aimed at fostering effective communication.

The challenge with these methods is that when they're most needed, people often revert to more... "basic instincts" :-), sometimes underhanded, forms of communication. They can even twist these tools to serve their own agendas. I wonder if a 'how to talk to me' manual might be giving potential manipulators too much leverage...

--

1: https://en.wikipedia.org/wiki/Six_Thinking_Hats


Ime these are always "write-only" documents. Sitting in PowerPoint on a SharePoint drive somewhere, never to be read...


On the individual level this seems absurd. It won't be read before contacting someone new. It will however annoy some people to have specified some arbitrary preferences and then have them routinely ignored by everyone.

Something along these lines is a good idea for a job listing though. Come up with a broad sketch of how the current team works and likes to work, have the team edit it until rough consensus, add it to the job listing. The best I've seen in that direction is https://github.com/symmetryinvestments/overview/blob/master/...

> Qualities and traits we value

Usually this is something vague around inclusivity and niceness. I can't remember the stated corporate qualities of anywhere I've worked, though the reality tends to stick in the mind. Symmetry have not taken that stance. The examples I find most interesting from that section are

> Practical people who are at the same time unreasonable when they ought to be

> Extreme and unusual intellectual capabilities

> Good taste and love of beauty

It's not enough to tell me whether I'd like to work there or not - in particular trading firms are usually obsessed with people sitting in office blocks - but it's higher signal than the usual waffle about everyone working together nicely to make things nice.


Alternatively everyone can just be grown up and behave appropriately in the work environment because that's part of the contract you signed.


I am going to dig up this gem from the old days:

Richard Stallman has rider... (see: https://news.ycombinator.com/item?id=3159210 )


Sorry but no. I still have to see a single company that REALLY have a documentation culture, meaning a new employee can find a book "welcome here, an overview of anything" and from this all relevant, up to date, organized information of anything she/he have to know, and yes, this would be really helpful, but I'm a human not working in prostitution so I have no user manual.

I normally have contracts I honor and I expect the other party honor as well, I have a reasonable human flexibility, tolerance etc, and all of that demand no manual. The company demand an onboarding manual and tried practice as much as possible because from remote the sole hard part is that. For all, in person or remote, the rest is about documentation in general, not crappy abandoned wikis, not "read the code" on a codebase that would demand years to be understood fully and change faster than such timeframe and so on.

I reject a future of meat-based robots on sale, I like a future of remote workers, humans, that know what to expect each others, because we are all humans, peers between peers.


What an absurd idea. What is it with the tech field and formalising every last bit of interaction? It is fundamentally dehumanising.


Jeez, I love not working for a big company.


> In fact, remote and hybrid employees score higher than full-time office workers on all elements of the employee experience, including on culture-adjacent measures like sense of belonging at work and value of relationships with coworkers.

This is being 'phrased' as though full time workers aren't experiencing any or their experience doesn't count. But looking at the charts and how close many of the results are, it appears more that the experience is split across the three types of workers, with remote only just edging out the others.


I just want an option in Slack that automatically rejects any message like "Are you busy?" or "Hi, I have a question" without notifying the recipient.


I can imagine a bot that one day responds to those messages automatically, using an AI with some instructions from the owner. The answers really don't even matter, so as long as no actual question was in the message, it can respond with anything that's polite. And it'll let the actual questions through.


Seems quite similar to https://www.manualof.me/


I wonder in what type of bubble this was created and seen as a good idea.

It seems like something that enables and promotes mental illness and would actually be counterproductive to uniting people towards a common goal, and rather would develop pettiness and fiefdoms.


The HR-mandated version of "Let's hold hands and tell each other a secret."


Just submit a DnD character sheet and be done with it.


Ummmm, since you are contractually working for another person or company, it is that person or company HR that defines the "Personal User Manual", and not the employee.


User manuals are for tools.


I hate all this nonsense. Just the idea that culture is a thing to be created, as if people are blank templates to be filled up on a mediocre manager's whim.

However - content aside - I actually liked the page layout. I liked the clickable, table of contents thing on the side, that disappears if the page is narrow. This sort of presentation of text is really nice, imo.


"Some assembly required. Batteries not included."


This is absurd.


I think either Adam Bryant (organizational psychology at Wharton) or Erin Meyer (same at INSEAD) turned me on to this idea. I think it's generally a good one to (very slightly) accelerate new working relationships to a place of trust, and the emotional pearl-clutching in this thread is interesting to observe.

The best examples I've seen of such manuals (and the best working relationships that have been informed by them) share a common thread: sharing about ourselves where useful,[^1] in order to help others know us better,[^2] and not to control or compel them to do any specific behavioral thing.

So, far from an "instructions [to follow]" (@phoenixy1) or "a one-size-fits-all approach to how different people should act with an individual" (@ralferoo), I think many people intend that the document simply share context in order that you can understand them better, and do whatever you like with the information.

There seems to also be a suggestion that producing such a document is in and of itself a burden to others (@jasoncartwright is very upset about the "arrogance" of even writing one, let alone "expect[ing]" someone to read it, @phoenixy considers them to be a "pretty unreasonable burden"). I can understand the reaction, but I think provided there is no expectation that anyone read it, or that it be a means of controlling or compelling someone to behave a certain way, it's pretty benign overall. (Like, I think everyone would at least once or twice in their careers have access to such a document about some colleague or another, if they thought it were relatively sincere? If so, I say go forth and self-document, just don't have any expectations.)

Here are the sections in mine:

1. Why I have this thing

2. The success criteria for my role, and some general ways I try to achieve them

3. Some general patterns of working (one-on-one cadence, skip mtgs, whatever)

4. Blind spots I have that others have experienced (all verbatim, sought from a mix of new/old colleagues, a few new ones added each year)

5. A few situations where those same people would encourage others to specifically seek me out in a jam (as before, all verbatim yada yada - not necessarily work-related)

6. Work things I love doing / work things that I find stressful (drawn from scenarios the reader will likely encounter)

Of these, 1, 2, 4, 5, and 6 contain precisely zero information relating to my preferences or instructions on "how to" do something. I'm simply providing what I hope to be useful context about me and my role at work. (Assuming you take me at my word that I am not sharing the things I love / things I find stressful for any reason other than you knowing me better.)

The general patterns of working at 3 contains some preferences relating to out of hours contact (along lines of "I don't check my emails or Slack outside of office hours, so you should call or text me if there is an emergency or if a few minutes of my time can save you several hours on something"). Maybe that's somehow outdated now? It's the sort of thing I like to know before I reach out to someone out of hours – a bit like I know some people who appreciate a heads up when visiting a "shoes off" household, so they can wear socks or clip their toenails.

tl;dr I think if you are clear that you have no expectation that anyone even read it, and share relevant, practical context on working together -- with a significant portion sincerely sought from a mixture of people, rather than your own navel-gazing -- these kinds of manuals can be a good shout.

I like reading them, and I like understanding my colleagues better. So I'll tell you that I would enjoy reading yours, and if you ever write one please share it, and that I hope you read mine. That's pretty much it!

[^1]: What constitutes " useful" is of course my determination to make, just as it's your determination to decide that what I shared wasn't useful, and tell me as much.

[^2]: I guess this is predicated on the axiom that understanding your colleagues better is useful. I suspect it is useful -- I think if I had to bet on whether or not any person is more effective in collaborative tasks with a stranger, or with someone they have worked professionally with in any field for several years, I would pick the latter -- although this is uninformed.


Writing this manual just sounds so incredibly tedious. Not only there is nothing much interesting even for me about myself, now I have to find something interesting (and useful!) for others. And obviously, I can't just leave an empty page around. Ugh.


What these things really do is give the reader an insight into _how you see yourself_

Will that be useful to them? Will that be of benefit to you? It depends


Amusing to read that I am "very upset"


If only there were some document where you share whether or not you would be open to feedback on how you came off. That would save someone the trouble of asking and wasted time if it's a no.


"Users on HN are outraged over suggested positive feedback manual".


[flagged]


There's a flag link on the submission.


I don't see it. Maybe I need more points to see the flag link?





Join us for AI Startup School this June 16-17 in San Francisco!

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: