Writing documentation for your house
luke.hsiao.dev
luke.hsiao.dev
One night she was streaming the teardown of a bathroom wall. There, in between the walls, was a clipboard with some notes. She slowly took the clipboard up and started reading. Of course we couldn’t see what she was reading, but she started to cry and sniffle.
The clipboard had a list of wiring and installations. Had been written in the 70s. But the front page was a note, she told as she started crying, that said that rehabbing is hard and sometimes lonely work. But to keep at it because one day it’s worth it!
That moment arrived at a particularly lonely part of the pandemic for her and those of us watching. Whoever wrote that note and left that documentation from 50 or so years ago of course had no idea how it would find the reader(s) but could there have been a more perfect, beautiful moment than the moment my friend found it in the wall?
Different times!
Precisely... or did you not realize the irony of your comment?
> On 31 August 1997, startled by the news of the death of Diana, Princess of Wales, Amélie drops a plastic perfume-stopper, which dislodges a wall tile and accidentally reveals an old metal box which contains childhood memorabilia hidden by a boy who lived in her apartment decades earlier.
https://en.wikipedia.org/wiki/Am%C3%A9lie
> While filing, Craig discovers a small hidden door. He crawls through it into a tunnel and finds himself inside the mind of actor John Malkovich.
https://en.wikipedia.org/wiki/Being_John_Malkovich
> A woman (credited as "M") mentions to her musician husband (credited as "C") that as a child, she moved residences frequently and took to hiding little notes wherever she lived.
After that I've done two more major jobs on other houses but I'm at the end of my enthusiasm for this kind of work.
The new owner sold the home after two years. From the listing photos she had ripped out most of the smart home stuff and had crappily remodeled (painting river stone hearth, etc). YouTube showed zero hits on it he videos I made. I sincerely doubt that she even bothered to look at the binder I handed over.
I will never put that amount of effort into documenting a home again. I know what I’ve done and I keep just enough docs around for my own purposes.
Of course some people get by with a simple float indicator, but why would I do that when I could be using high accuracy hydrostatic sensors, esp32, influxdb, grafana, spring, keycloak and mysql running in AWS?
I certainly wouldn't want to be getting support calls if we were to ever sell, so I would probably remove it myself if that happened.
> grafana, spring, keycloak
Managing storage and more can still be work and worth doing as a second step since most of the time it’s worth doing the setup over at least one more time.
Back in the early 90s — on a recommendation from a realtor who was a close friend of my brother's — I hired an inspector who was close to retirement. He worked with his wife who served as his assistant tasked with, in essence, taking dictation of her husband's near constant commentary as he conducted an incredibly thorough inspection. Every outlet tested for proper ground, every nook and cranny looked at, wood moisture content, HVAC pitot readings, masonry, roof … just a super-duper detailed inspection that took about 6 hours to complete.
At the end of the inspection, he summed up by saying the house was good and that he had no qualms recommending the house.
Two days later, he stopped by with a three-ring binder that contained his inspection report. It first contained a summary that concisely covered the positive and few negative aspects of the house. Then there was a section about the history of the house: the year built, the name of the builder, changes in the neighborhood since it had been built, earthquakes it had gone through, flood events in the area, and so on. It also included the manufacturer names of things such as the windows, door hardware, etc.
The third section was lengthy, covering the precise state of the electrical, plumbing, structural, envelope, etc, and included all the notes his wife had taken during the course of the inspection. It included a sub-section with warnings about certain materials that likely contained asbestos and would need to be dealt with if we ever did remodeling.
Finally, the largest section was what he called a "maintenance work order" arranged as a schedule for the ongoing, recurring upkeep of the house but beginning with things he thought needed to be done immediately, replacement of the circuit breaker box, splash blocks under each outdoor faucet, tuck-pointing some of the chimney's brickwork, etc. And then his estimates as to when he thought systems might need to be replaced, the water heater, furnace, roofing, etc. As I discovered when the water heater burst, his estimates were pretty much spot-on. Over time, I added notes as we upgraded things, added low-voltage wiring, and remodeled the basement.
Nine years later, when I sold the house, the buyer was elated to have this owner's manual and I am fairly certain that the book was key to a very fast sale of the house which we did without a realtor.
As I look back on it now, I realize that inspection was perhaps the best $350 I have ever spent.
When we bought our next house, the inspection took about an hour and produced a few page report, most of it boilerplate.
Though I wonder why they didn’t recommend preventative maintenance on the water heater- if it was electric, why not replace the sacrificial anode?
When we bought this place, the water heater was old and I decided it was a better plan to just leave it alone and replace when it leaked. (There was nothing valuable on the mechanical room floor.) A year later, we had a new heater and 15 years after that, it’s about due again.
I can definitely understand the “do nothing” approach, particularly if the rod is 10+ years in situ.
I tried to do that on my old water heater, and it's probably good I gave up. I couldn't get that nut to budge (even after buying some pipe to make a long breaker bar), and I think there's was a good chance I might have wreaked it if I did.
The thing was small, and we eventually just replaced it with a larger one that has the benefit of being new with a much more reliable control unit.
This is like writing code vs figuring out someone else's code. Those are totally different things, and code is a bunch of readily accessible text files. Smart homes? Some device in the attic, some device in the basement, some wiring that goes who knows where, where does all this info go? What was the model of this shit? Oh it has NOTHING on the front because serial numbers are gauche.
Leaves what people are familiar with and trust in place.
I'd really like some kind of standard for model IDs. Maybe something like a domain name and a model number.
It would also be good if devices came with a QR code printed on them that linked to the manual.
And this is on the hardware side. Software? Did the former owner have passwords and everything tied to HIS ACCOUNT? Does he hand over some account? What personal info is in that former account. NOPE, big nope.
The problem with smart home is this:
- if the company wants to make money on the software, it will go with lock-in or fake open, which is what it is today. And that is a miserable failure
- if the company wants to make money on the hardware, the software is a cost so it sucks.
The solution is PROBABLY that the hardware vendors can only implement protocols, but CANNOT implement middleware. It can basically only provide information and take commands.
The a software company makes the hub. It cannot have any interest in any particular devices, it cannot "partner" with a hardware firm.
But of course that's only one part of the problem, with security and the central account. The software hub would need to provide some way to "move" an account with transparency on historical data reset.
But the industry is so effing far from this. Maybe SmartThings was close, but they got acquired by Samsung and now push Samsung products and basically discontinued everything pre-Samsung. They highlight that there's no good money in pure middleware.
The device vendors have to come together and do some sort of independent software company that they all can't meddle in. But then there's still soft pressure to only support devices in the "in group", so that still doesn't work.
Really, this is an operating system + driver problem. The central core is the OS, and the devices are "drivers". A consumer OS can be priced at about $50 tops, and it needs about 10 million people a year buying it. THen it gets the critical mass.
The other option is that some group close to the core of Linux take this on as the next big project. This could have important implications for Linux desktop, because it would create a Linux-aligned group that all the device manufacturers have to prioritize, and that provides the outreach to them also supporting device drivers for the Linux OS.
I mean, that is a BIG undertaking. It would take someone like Torvalds with talent, hard work, and some form of charisma (not necessarily Torvalds' brand)
They could even install something that isn’t necessarily connected to the internet but can be remotely accessed from nearby.
At the same time any home automation needs to be able to be cloud and vendor independent.
It begins with registering the property an independent email address for any accounts used during setups before taking them offline. Easy to manage for future tenant or sale.
Gear is more able to be cloud independent or be made cloud independent, leaving a greater chance to leave at most a local wifi network and local appliance with touch screen (pi) that can peacefully operate without the internet, plugged in and hung on a wall like any other appliance in a mechanical room of the home.
The more off the shelf parts can be, the greater the chance of it surviving.
With each iteration and replacement I’m discovering there’s more out there.
For example instead of using a random computer or pi, installing a home assistant yellow presents to a future home owner as more of an appliance.
https://www.home-assistant.io/yellow/
This is a nice gateway for non technical but “I can find someone to help me with this system”.
Same goes for particular groups of hardware.
You’re night it’s a mix but the fact you can run most things on one platform fairly easily is pretty useful.
It definitely changes my decisions on further purchases. No smart switches that don’t revert to being dumb if the smart stuff fails (as it always does).
Of course there are available possibilities to take somehow full control of your automation with some Home Assistant or the likes but honestly, it’s really not that easy if you are not already a tinkerer.
Great automation will also require more work and knowledge. As soon as you start playing with heating or venting, you are doing work that could require some background. It’s something to buy a nice smart thermostat, but it’s something else to understand where you may place it, how you may program it …
It’s an interesting topic for those who like to tinker, but it’s very understandable that most people aren’t going to invest their time on it.
I replaced almost all my bulbs with smart bulbs, and then got annoyed having to ask Google to turn on the lights all the time. My solution? Even more technology of course. I found these little buttons that fit neatly over my existing switches so it not only keeps the switch in the correct position but makes it just as easy to turn off/on as before. But now they're dimmable and remotely controllable which is a plus in my books. Also my apartment is dumb and barely has a single built-in light so it's just lamps everywhere; without smart bulbs I'd probably have to flick a million switches or lamp-ropes.
Yeah it was great for the previous owner but it sucks for me as I have different tastes and needs.
I am going to rip it all off and do what I want.
But in reality I just don’t buy anything that is advertised “one of a kind” because I know it will be more of a hassle to deal with it even if it looks cool.
For me cool looking fancy stuff does not add value but rather lowers the value because I know I will have to rip it all of which is just more work. I also rather buy apartment/home with some default IKEA kitchen because I know then it will be super easy to rip it out and replace with what I want. Where most of the time I think I would just stick with that default IKEA depending on how long I plan to own the place.
Also starting and maintaining a fire in the wood stove is something I enjoy.
Some of my favourite automations:
1. Whenever someone arrives home and it's started to get dark outside, automatically turn the hallway lights on if they're off 2. When turning off the TV in the lounge, and it's dark outside, and the lights are dimmed, bring them up to 100% warm white so you can see where you're going 3. Motion sensors in the hallway and landing to turn the lights on when they detect motion at night.
Do I NEED any of these? Of course not. But I like having them.
Other thing is I hade all kinds of status LEDs - it is just insane with the bright ones. I know it is nice for quick troubleshooting during the day to know if the internet is on or not - but in the middle of the night they should be lowest brightness on all appliances or turned off. But not all vendors provide the option.
I agree, it'd be super annoying if it turned the lights on full power. I had a motion sensor light in my old apartment. It was part of a Hue system and it would turn on a single bulb in the hall or bathroom (can't remember which) to the very lowest dimness level if someone was walking to the bathroom at night.
On my office desk with my computer setup, I have a pair of Vanatoo Transparent Zero speakers, which had a bright blue obnoxious LED that was way over the top... until I looked in the manual for some other reason and discovered you could actually hold one of the rear switches and turn a knob to dial the intensity all the way down, or off. I love that.
My partner has a corner desk and works from home 3 days/week. I also have a backlight "rope light" behind the TV.
During the day, when she's working in that space, the lights are 100% intensity daylight white, and the backlight a cool turquoise. At sunset the lights go to about 70% warm white.
Automations are also hooked up to my Harmony (I really hope someone dives in to this space, but I don't hold up hopes - there are a couple of options, but right now no-one seems interested in picking up from Logitech unless you're going to the ultra heavy, and ugly, last I checked, offerings from Creston, etc.), such that if you turn on the TV, then it turns off the front row of lights (parallel to the TV wall) so there's no reflection, and the second row, which is just behind the couch back, goes down to about 10-15%, slightly warmer still, giving a movie theater vibe. And the backlight on the TV turns off. I debated the Hue accessory to match color to HDMI output, but I think that seems like more of a distraction than an aesthetic.
I'm glad you enjoy maintaining a wood stove. I like asking my house to turn things on and off when my hands are full, or automating my bad habits and forgetfulness away.
For top marks, have a train set with cardboard cutouts on and party music playing loudly every evening.
Funny that, I'm sitting on my boat and it's soooo pretty, but one thing I really won't miss about moving off it is maintaining the fire in the stove. And especially the temperature when it burns out or dies out...
Yes, definitely. There's something satisfying about it.
I've spent the last few weeks splitting logs - some by hand, most with a hydraulic splitter - and it's been so peaceful and good having fires on the back deck the last few weeks. It's not super cold here (Texas) but just chilly enough to make it fun.
I finished this past weekend: https://twitter.com/CaseySoftware/status/1728507279001923983
So in some rooms I have many separate lights operating together, and in my bathroom I have a one of 6 spotlights (which are all in the same electric circuit) operating independently.
As for "hassle", i probably spent a week setting up Home Assistant on a raspberry pi a few years ago and haven't touched it since, apart from replacing switch batteries whenever they get low.
I'm never going back.
Having said that, I'm not interested in automating anything else. Maybe home heating. I have an old 2 zone system, so adding smart thermostats to my radiators would provide completely independent control from every room in the house, whereas right now I just have a dumb-dumb "upstairs" / "downstairs" setup.
The thermostat is an ecobee, which is a pretty polished IoT device but I'm frustrated i couldn't get something _more_ local. It speaks homekit so I can do a number of actions entirely locally, and if the internet is down it still works, but I do wish it were more self-contained. So again, if I sell or get angry at technology and chuck my HomeAssistant Pi out the window, the thermostat will just work as a thermostat.
Likewise, my blinds are motorized--but they have a working remote paired directly to them. It's incredibly convenient to raise the blinds in the morning for some sunshine automatically and close them after sunset, but they'd work perfectly well without a smart home.
If you purchased my house, you probably wouldn't even know to rip out the "smart home" components because they fail over to just being normal components.
It is not particularly hard to make this method of operation happen, although it admittedly requires a budget above "dirt cheap."
Except that most normal light switches (that I've encountered) are a toggle and not a momentary.
Also, in most applications, a big LED to indicate state. Often installed on the ceiling in a central location where it's easy to see from any point in the room.
However with switches I go hard opposite. Reproduction push buttons, with antique brass plates acquired at auction.
The downside is perhaps that when someone encounters them for the first time, they spend 10 minutes flipping them on and off.
I would however install in a moment motorized blinds like you describe.
I own my home & am into automation - but I don't plan on living in this house forever. As such I try to only install things that can be easily reversed when I move out, e.g wireless instead of hardwired smart switches - devices that piggyback on 'normal' home things. Otherwise I'm just giving the next owners thousands of dollars of things they don't want & unnecessary headaches.
That's an optimistic view. I think the most common position would be one of active avoidance. I know that's true for me.
It's like shag carpet: faddy, kitsch, and high maintenance. Smarthome stuff in particular is just so overkill. I don't want to overengineer my home. I don't want apps and QR codes and documentation just to water my garden or operate the lights. I'm not a nerd who enjoys tinkering with this stuff. I have shit to do. I want my hose to work like a hose, my washing machine like a washing machine, etc. And that's the case for most people.
Playing with smarthome gadgets is a fun niche hobby, but it's not a hobby most people want.
We had made all these plans to renovate the upstairs which was all that was needed. Then the day of the sale came, we got massively outbid, it sold at a silly price. We figured whoever bought it loved it equally.
Nope, a year later it was back on the market. The dining room had been torn out to make the ground floor open plan, the hardwood was completely replaced with cheap grey vinyl floor boards, and the fireplace was replaced with a small dining area.
It was painful to look at was clearly a well finished house turned into a cheap looking listing on AirBnB.
I bought a house that was empty after divorce, both had moved out some months before. We mostly dealt with the agent, only saw one of the previous owners for a very short time at the signing meeting with the notary.
Then in the house we found a "congratulations on your new place" card, a bottle of sparkling wine, and a binder with everything about the house. Building plans, updated plans for changes made, exactly where every cable and connection was, and manuals, invoices and warranty certificates for equipment in the house. And a hand drawn map of the garden with what type of plant was where, and links to plant care instructions for some of the more exotic plants.
Super nice of the previous owner to arrange these things, and I'm still thankful every time I need to get a cable somewhere or do some small construction things. Having detailed and accurate plans and overviews saves a lot of time.
“Closed walls hide many sins.”
The things like L1 and J4 etc indicate which switches are connected to each light fixture (the number matches) and on which breaker (the character) they're connected.
Similar for construction, a plan for where all the walls are, which ones are load bearing and which are not etc.
I have a whole stack of them for various things.
I moved back to Seattle a few months ago, and my 17 yo son, who was literally born in that house (on a Murphy Bed i built, also included in the manual (the plans, not that my son was born on it, how weird do you think i am?) went and knocked on the door, and he asked if he could look around (outside). They apparently looked at him as if he was deranged, but said sure.
He reported back that they had razed the brick oven, the one thing i thought would out last me in my life. I hoped that one day, maybe some kids would be eating pizza from this oven 100 years from now and no one would know where the oven came from.
Yeah, I haven’t had a house since then, but i will do it again, document everything. I will just be pickier about who i sell it to.
Pools are the same thing - should be valuable to the right buyer, but in practice worth zero. Even the most valuable remodels - kitchens - often are worth less than not doing it at all because while it adds a lot of value to the house it doesn't add as much as they cost.
Not saying what should or shouldn’t be done, but the implication here seems to be that that’s a lot of yard space. Depending on yard size, that could be a crippling amount of space to lose, or just a drop in the bucket.
I don’t know anything about Seattle yards. I’d kind of expect them to be on the small side, but maybe his wasn’t? He obviously had some amount of land, but from his post I really can’t tell how much.
There is no expectation for the new owners to share the prior owners interests. Maybe they are gluten free. Maybe they are the kinds of people who have zero inters in baking, whatever. You can’t expect them to use the 64 sq ft of their yard as a monument to something you did if it’s not relevant to them.
I do get the idea of being attached to your home and hoping it goes to good hands. We have that kind of relationship with the folks we bought our house from and that’s great. But there is no expectation that we won’t change it to suit our family.
That was already the case in my grandparents generation. On my father’s side is a large farm, but my grandparents moved into it. The eldest lives there, and a few of the aunts and uncles have shares from inheritance so they might move into it eventually. Most of them made their lives elsewhere, and their kids went even further afield.
On the other side, the grandparents came down from the mountain, built a house, the kids made their own lives throughout the country. The house was sold when my grandmother died a few years back. And she died in that home, for most of my friends the houses were sold when the elder had to move to assisted living (or worse when the house was lost for lack of income).
Generational homes were a thing when people didn’t need to move around, but my own parents moved 4 times just in my lifetime. So far.
You may sell the house, but you keep the memories. It sucks your grandkids won't be able to eat from your pizza oven, but you did, and you can talk about how you made it, and how much you enjoyed it, and that lives on. My parents sold their home a few years ago, and while my dad will regularly talk about how he misses it and what terrible changes the new owners make, it doesn't change that I was raised in that house, and we had great times and memories there, and he will now have a chance to make them with his granddaughter in his new house. It stings, but try not to let it.
Honestly this kind of mindset is a huge problem in the US. You built the oven, you enjoyed the oven, and you decided to sell the house. Why do you feel the need to dictate what the owner does with the house after? If you wanted to keep the pizza oven as some kind of monument to yourself you could have kept the home.
This kind of mindset leads to stale neighborhoods, where some locals feel the need to dictate neighborhood look and feel. You end up with regulations that don't allow new construction and can even dictate dumb things like paint color. All to preserve a memory of something that is only important to the people that got to enjoy it when it was new.
This is not say nothing should ever be preserved if there is actually something of historical importance that happened there, but it seems like there's a mindset to preserve things that are trivial to the many and important to the few. Then there are places with actual historical significance [1] people are willing to just rot.
1: https://www.theguardian.com/us-news/2018/mar/30/rosa-parks-h...
Honestly it is kinda depressing that anyone thinks otherwise! like somehow we should respect capitalism and $business$ more than, like, feelings.
Beyond the sentimental attachment to the pizza oven, I'd be bothered by the sheer inefficiency of it.
This is the part that hurts me the most. I don't like when good things go to waste.
It’s nice to think we might do something that lasts a long time but the more nonstandard it is, the more likely it will be changed someday.
A similar effort on a fancy “outdoor kitchen/barbecue” in a more outdoorsy state than WA may have lasted a long time.
An awful local law may have dictated that the OP should not have been allowed to build a pizza oven in the first place, because people want to preserve the look and feel of the neighborhood when they moved in. But I also view it as equally bad if the new owner couldn't tear it down because of some HOA regulation saying that structures built before some arbitrary date, conveniently a time after they moved in and did their renovations, can't be torn down. The only real reason being the sentimental value they have to that past.
It sounds like less of a problem than its opposite: "Nothing matters but how much money I can make."
I have a quote from the OP, but address matters from the entire comment.
You are arguing about two sentences.
"The polar-opposite behavior is a bigger problem" is not "whataboutism", the relation is direct and practical.
> Your post history seems like you exist to be an example in a Wikipedia article.
Thinly-veiled personal insult, check.
If OP loved it so much then he should have moved it. Once he's sold the house then it's not his business anymore.
I share the feeling though.
Now, don't begrudge the people coming after you for doing the same. It's their house, not yours, and they have the chance to make it how they like it. If you want control over a thing, don't sell it. Similarly, if you want to dictate what your employees do during non work hours, you have to pay them for it. You treat something as a commodity, and it becomes a commodity.
Came time to sell the house, and I told the buyer, the hot tub is great--we'd love to keep it--if you don't want it, we can negotiate that, and we'll arrange to actually move it to our new home! They didn't respond and bought the house anyway. I find out from my next door neighbor that the first thing they did when they moved in was demolish it and haul it to the dump.
Hey, it's their house, but some people are just wasteful.
My realtor was like, "this basically means the house costs $500 more", but I went ahead and returned the door.
If you're faced with that situation in the future, you could try including a clause like that in the contract; the $500 wasn't really the motivation for me to immediately replace the door and pack up the old for shipping, but putting a little money on the line might motivate the buyer to at least value the feature you'd like returned if they don't care for it.
My furnace has the install date in sharpie on it, along with maintenance dates.
The main sewer line has the last time it was cleared, who cleared it, and where the blockage was.
An industrial label printer makes these easy.
So does a sharpie.
This is my preferred method. "Permanent" things go on the thing with sharpie. Other stuff gets sharpied on some masking tape and stuck on.
If my furnace ever walks off and takes the install date with it... chances are the install date's no longer relevant. Otherwise the documentation for my furnace is... on the furnace.
Sounds too simple, I’m skeptical it could ever work.
It's handy to know where wiring runs are, how many studs are between windows when mounting tv's, and a dozen other electrical, ac, or plumbing issues. I used it once a week initially and probably once every two months now that we're settled.
Also recommend a Dymo Rhino 5200 cable label maker with heat shrink tubing. I print the label on some heat shrink, attach it to a wire, and never wonder where anything goes again. Great for vehicle wiring harnesses too: https://www.youtube.com/watch?v=-LcUQeTzIo4&t=66s But I'd recommend the 5200: https://www.amazon.com/DYMO-Industrial-RHINO-Label-1755749/d... - non-affiliate link.
This has the affiliate tag of: pmg097-20
Without any affiliate link it is: https://www.amazon.com/DYMO-Authentic-Industrial-RhinoPro-18...
But also things like the paint codes and finishes for every room, trim, ceilings, etc. That really comes in handy when you have to do a drywall repair or something and the only can you have left, the paint has slopped over the label.
I also had a separate notebook for The Move and The Purchase. It had all the contacts - mortgage lending officer, realtors, inspectors; appointments, vendors, dates of major events; move-in punch list, move-out punch list, inventory with what to keep, what to toss, what to donate. Expenditures, documents to drop off at which municipal offices along with addresses and phone numbers.
It's really empowering to have all that information literally at your fingertips.
Paint codes alone are so worthwhile. My current house has three light greys in it that are all subtly different and when I moved in there was just one grey paint can in the basement with no indication which one of them it was.
Each major line of paints has slightly different colors, so figuring out of it was Sherwin Williams, Behr, Valspar, etc let me identify the right color collection and narrow things down enough for me to guess what he was using.
A chip as in a sample of the drywall... that I've found to be much more of a mixed bag. My last "matched" paint was nowhere close once the sun was shining on it.
Source: this happened to my mom and she ended up with slightly discolored spot that people always assumed was a reflected light source.
And since I took ownership of it, and have I been ever grateful that he documented it, I have done the same too, for the WiFi, for the networking, for the tool shed, for sit-to-stand desks, for the oven, for the plubming, and so forth.
And I've applied the same rigorous principle to the house now as well for about the past three years. I kept documentation prior, but nothing so deep until the RV came along.
Two thick ring binders, one for the house "chassis" and one for the appliances in the house.
Instructions on how to reset the internet, instructions on how to "reboot" the water heater, instructions on how to change the AC filters, the model numbers required for the filters, and why there is no "air return" vents on the AC for the next owner, and also as a reminder to myself. Documentation on the maintenance of having the black water lines replaced after one of them collapsed, how to access the clean out hatch on the black water lines. Where wires in the walls are run too. The circuit breakers are each carefully labelled too. It gets written up in OneNote so it is searchable, and then it gets put in to the three-ring binder, with sections for each area, e.g. garage, master bedroom, kitchen, etc. And lots of paint codes for each individual wall.
It doesn't take long if you do it step-by-step rather than try to boil the ocean all at once, and you will be grateful you did it for years to come. And your home, unlike the software developed by your team, doesn't tend to change all that fast.
You fill in the blanks online and it generates the PDF for you.
Profile has my email.
[2]: https://gitlab.com/DaveJarvis/keenwrite-themes/-/tree/main/d...
It's awesome.
Us tech people love to over-complicate things sometimes.
I tape the manual and the transit bolts of a dishwasher to the top of it and that's it. For heating and stuff, a laminated sheet of paper attached to the pipe does the trick. If you love all things digital, create a shared online folder filled with .docx documents. For those you'll find a tool to open and edit them in 40 years time.
Sure, for some the creation of the digital stack is the purpose itself. But documentation that lasts decades? I don't believe it.
He knows the skeleton of this house in a way I never ever will. He lives 50 miles away now, but I still have him as an amazing resource about my house.
I wanted to run cat5 to my office on the second floor a number of years ago. "Oh just drill a hole in the floor right here in this corner, there's a void that goes all the way from the second floor to the basement." Sure enough.
What I want is the schematics that my dad has in his head.
If they’re good, they’ll know what you want and they will also help the builder avoid callbacks. Many things are insanely easy to fix before the drywall is up.
I also recommend that you do the same walkthrough, of course.
Probably, when you ask him this stuff, he glows inside.
Centralized documentation is great, but who reads manuals?
People will see comments in the code. They may even bother to read a README.md dropped in the same folder as the files they’re looking at. They probably won’t look in a docs/ folder in the root and they’re almost definitely not going to go search Confluence.
Centralized documentation is great for high level information. “Here’s an overview of the water treatment system.” You know where I wanna see instructions for resetting the alarm after cleaning the filter? Beside the filter.
Most of my “home documentation” is sharpied pieces of masking tape stuck around the place.
I’m a proud “organized person” and have documentation for family and relatives. I’ve got the “Inventory” for most major appliances and long-term items in the house. On my wife’s side, they are a massive Indian family with 20+ cousins across each generation living in large mansions spanning a tiny community. Most of the time, the wife or I would call from across the country to ask where “that was kept,” which services go where, and which cable (I labeled most of them) to look for when the Internet goes down. The in-laws would keep a list of what to set up, fix, and organize when I visit next.
I’m not in favor of using any software or tools for these. I want to stay with OpenFormats, plain-text, PDFs, etc, organized in files. Since the pandemic, I have been slowly documenting and collecting the medical records of my immediate family. This has helped a lot when the father-in-law had to go through an extensive heart-related treatment last year.
Thanks for doing this. This is a big inspiration, though a tad more micro and technical than I wanted. I suggest others who haven’t started something — stay simple and keep it to files — something that would have worked 20 years ago and will likely work in the next 50 years. If you use a tool, it should be like a varnish on top; the contents should work on its own.
Well I want to see the Bollywood musical about that family, preferably with a triumphant return of Priyanka Chopra, and music by Devi Sri Prasad.
Once, the Father-in-law had to be told to stop his speech mid-way the 30-min mark at a family gathering. Yes, the family often had to organize big meetups and the elders had to give speeches. This is a family spread across countries, embracing multiple religions, languages, and beliefs - so speech-lot-happens-a-lot.
My wife wants nothing to do with the rental aspect but when she had to handle management for a few weeks she couldn’t stop gushing over my OneNote administrative guide.
The idea is that I can literally give anyone acting on my behalf access to the utility room, they grab the binder on the wall and mitigate the issue exactly.
[0] https://en.m.wikipedia.org/wiki/Quick_Reference_Handbook
I was tasked with replacing the Eero WiFi mesh with something that actually worked. We needed APs both upstairs and downstairs to provide sufficient coverage - especially through the lath-and-plaster walls.
It was _really_ frustrating for a couple reasons - first, the original design left no open risers to run cabling between the floors and even thought there was a nice 3' tall attic between the ceiling and flat roof, there is no access to it save a 1x2' port in a closet which is blocked by framing members and retrofit HVAC ducting. Secondly, over the years, multiple generations of cabling had been installed allover the building - several sets of coax - presumably for TV as well as CCTV, and bundles and at least 5 different generations of CAT-5e and CAT-6 had been run from the equipment closet across the house through the crawlspace and up through the walls to the second floor and attic. In all cases, the bundles of cables had been clipped off and shoved back through the floor or the cables were cut off, their wall boxes removed, and the holes plastered over leaving it all essentially useless. It made the interior nice and slick, but completely wasted all the effort of the generations of previous installers and perfectly good cabling.
Why couldn't they have just left everything in place and used block-off plates, or plastered over but left the wiring un-cut and documented the spots where the cables were. Or something, anything.
I was able to tone out a cable that I could reach from the ceiling access port and another in the crawlspace, re-terminate them and poke the other ends back up through the floor in the equipment closet and get a couple APs installed, but what a PITA.
/rant
It's roughly organized by room. General Utilities have their own pages. Drawings, Photos, Invoices all get uploaded there. My wife writes down where which plants got planted in the garden and how they need to maintained.
My hope is that this not only helps us when trying to remember where we put those cables or when an inspection is due but will also make selling in the far future a bit easier. And of course future owners will hopefully thank us.
Even putting aside the practical value it could provide to the new homeowner, it shows the house has been well-maintained to the potential buyer. It also conveys that there are likely fewer "unknowns" about the house because it implies nothing is being hidden.
I like the structure laid out here, gives me a good idea on how to start on something that would work for me.
My strategy that has scaled well over several homes: write install date/vendor/serial on the front of appliance manuals and keep them in a folder. Yes, you can scan them but it’s often easier to look at a paper manual while troubleshooting an appliance.
For notes, punchlists, “how I did it” reminders and details, a shared Apple note or Notion page or Google doc is great. Spouse acceptance factor high and participation factor higher.
Was great when my youngest wanted to make her first coffee herself. “Open your phone and go to home.family.tld and click on howtos!”
That said, there are some good additional ideas in the post and this thread that we’ll have to consider incorporating.
For example, your HVAC, water heater, central circuitboard, and central air system can have maintenance schedules and technical info, but that can be hard to know, because all you usually have is a model number.
Likewise with the coming home solar revolution and home storage systems, there will be other major systems that will be long lasting and major cornerstones of your house.
Also, your utlities can provide info. All of it can be centralized into a dashboard.
What I want to avoid though is the geewhiz smarthome. Sure it can integrate with that eventually, but I think people would like better info about a basic dumb home.
Maybe provide a service where someone comes (or they send you a kit) to scan the house with those things that can see through drywall, scan for heat maps/leaks, or just scan the shape of each room and form a map of the house. Of course this provides opportunities for upsales and the like.
Pulls data from Swedish public records - not sure how it handles other countries.
But tracing all the Cat5 cables, and security sensors (if you have a hardwired security) is a PITA. And you WILL need to tinker with them eventually.
As for hidden "time capsules" - I actually left one of those as a kid in a house that was being built at the time. About 45 years later, with me long moved to another continent, that wall was being modified and they found the note behind the paneling and sent me a photo of it. I hadn't remembered leaving it there.
We based in Estonia and soon new real estate developments here will come with our platform instead of the paper documentation. We are currently looking into the US market and if you have any ideas or feedback, email me at: rasmus@dobu.ee
The nice thing about this setup is that editing is pleasant (and fast in iteration), I can use categories to group pages together and I can use some interesting plugins, like the one to embed PDF files into wiki pages.
The latter (embedding PDF files into wiki pages) is particularly useful because I can browse appliances manuals directly from the wiki page itself or download them if necessary, and I have a "Manuals" category where i can find all the manuals I have collected so far.
Biggest advantage is that Notion is pretty good with multimedia content — embedded photos / videos / PDFs, gallery view for databases... And the best documentation for a home is often just pictures and videos.
- Here's how the sauna guy wired the equipment - This is what the old room looked like before we changed the walls - These are the xmas ornaments we're storing in the garage, etc
PS: I love Obsidian but use it mostly in single-player mode
I was so impressed with my accomplishment. Then I'm not sure what happened. The database wouldn't open anymore. None of my backups would work neither. Super confusing. 100% sure those backups ought to open but super wierd.
Worse yet, it should have been plain text disk storage... it wasnt anymore? There isn't any encryption or passwords for this simple app.
My tip: Make sure you use an app your familiar with.
This all might sound very cynical, but it really does seem like incentive misalignment.
I'm an ideal world, every home would have a permanent, up to date, digital record of all the relevant home info. Building planes, modifications, maintenance records, paint and shingle colors, wire and plumbing placement, maybe even a 3d model of the home with structure, plumbing and wiring info. Unfortunately, I don't see how a homeowner would be better off giving that info to the next owner.
- utilities and where they're paid and expected cost
- issues if any with common appliances, e.g.
- dishwasher occasionally needs to be manually spun with size 7 hex key (placed under)
- who I've given keys to- where I pay rent to and when and how much
- how to request access to the home lights and voice system
I just call it a House Manual and since it's easy to put pictures and stuff into a Google Doc and you can put videos somewhere else. The primary consumer of this is me. My wife just remembers everything.
I will probably create this as a wiki or github for my home with markdown files. Thanks for the inspiration. Cheers!
I always hand a copy off to whoever ends up owning the house, I doubt they ever use it, but it's handy while I am doing it to keep track of stuff. I do it for me. If it's useful for others, that's for them to determine.
Although, even as a developer, I am not a big fan of how much time and energy we need to spend maintaining documentation. So while I build something to work towards automating documentation in software (with my effort at vibinex.com), I have also been thinking about home documentation automation.
Another one was related to furniture modifications so that it efficiently utilizes space according to the need (similar to many modular furniture concepts). One of these ideas, I have documented here: https://avikalpg.github.io/blog/articles/20210923_proj_dual_...
Simpler ideas were the same as the original post: an app for everyone in the house to keep track of inventory or chores. I was thinking more about chores because someone might have done a chore I am unaware of - so I might either make duplicate efforts or procrastinate. But this is not a great idea because 70% of this can be solved using a WhatsApp group and asking everyone to update it whenever they pick or complete any chore.
If I'll die unexpectedly or fell ill seriously my family do not know how to handle Home Assistant and many parts of the home automation, even if it's not something exceptional an average electrician really likely can't as well understand how things works because... Automation is software and most only know pre-cooked tools by some well known brands...
However even if I'll document anything a day I'm not sure who can profit from such docs, essentially nobody would keep up a homeserver for third parties, at least not at a reasonable price...
What tools do people use for this stuff?
I wouldn't do it digitally, because I also keep paint samples and notes that I've taken during the work in the binder. If I had to re-enter those notes I don't know that they would happen.
The only flaw in my system is I tend to use a kind of short-hand in my record keeping. Thus, when I gave my Mazda 5 minivan to my daughter and son-in-law, I had to explained a few things. :-)
A word of caution: Never give away a vehicle that isn't in safe working operation! I put a lot of money in the above Mazda to keep it safe for myself. I would still be driving it, I just needed a truck.
Probably not as usable as this system, but pretty low effort and able to be passed on to the next owner easily if/when we move
The future owners will have a manual detailing everything worth knowing as I judge it.
I recently had drama with a contractor... it went into mediation, and the contractor was able to say, "How do we know this damage wasn't caused before we got there?" Contractors are shady, and likely that wouldn't change, but I wish I had more photos of my house before the flood.
https://www.linkedin.com/pulse/anyone-have-connections-usaa-...
For example, the fridge will continue to run on its UPS for another 18 hours. After that, items to be saved need to be moved to a portable fridge and plugged into the 12 volt outlet of the electric car.
While organizing the documentation is very nice your future self should be able to find what they are looking for if there is just a log/journal. I don't think it needs to be very organized unless it is consulted frequently.
Then I have another Trello board where I stick documents and reference material.
Home inspectors aren’t it either, as they don’t really give any idea of “technical debt” that isn’t glaringly obvious in my experience.
I’d pay good money for a static analysis of my home
This looks a lot more organized and polished, but I can also highly recommend a Google Drive folder consisting of a main Google Doc, and all the various PDF copies of manuals that it links to. I plan on handing the runbooks off when/if we sell…
I have a steam-based heat and didn't understand, when I first moved in, what was required in terms of maintenance. You MUST flush the boiler at least every season and preferably once a month. 5 years later I needed a boiler replacement-- just shear ignorance on my part.
1. https://www.searchenginejournal.com/google-robots-txt-noinde...
FWIW, what I specifically have in robots.txt is
User-agent: *
Disallow: /
which seems to work well for me so far (i.e., I do not find my house documentation site on any search engine).[1]: https://developers.google.com/search/docs/crawling-indexing/...
I think the point of it was that you could tell Google to crawl some pages (for links) but not index them?
An engineering friend of mine has documented and labeled every aspect of his vacation rental in Hawaii.
The only thing is, it's styled the same as the 1980s terminal systems he worked on down to the embossed black tape labels that gets attached to every switch, knob, and dial.
Treat your house like a black box.
The site is a simple statically generated site (I use Zola [1]). The theme of the site is inspired by Researcher [2], a theme for Jekyll (another static site generator). I've been meaning to open source my version and add it to the official list of Zola themes [3], but just haven't gotten around to it quite yet. I also use openring-rs [4] for the pseudo webring at the bottom of the posts.
[2]: https://ankitsultana.com/researcher/
I would be glad to use your theme whenever it is ready.
I did some of this for my house sitters, since they need it.
The cynic in me, says entropy will destroy your house and your documentation
… but I also read a touching comment on this thread to the contrary, so what do I know :)
Granted, he has a PhD, but must be nice…
My mortgage is less than the rent of our previous 1 bedroom apartment in Sunnyvale!