Documentar tu casa
(luke.hsiao.dev)- A los propietarios primerizos les cuesta encontrar información como instalaciones, historial de reparaciones, modelos de productos y cómo cortar servicios, y plantea que una casa también necesita un manual de usuario con estilo de documentación técnica
- La documentación de la casa puede dividirse, como Diátaxis, en tutoriales, guías prácticas, referencia técnica y explicaciones, lo que facilita organizarla según el tipo de pregunta
- Si a los cuatro tipos de documentación se les añade un registro de cambios, se pueden seguir trabajos y costos como reparaciones de plomería, cambios en el sistema de riego, instalación de alfombra y remodelaciones
- La implementación puede ser tan simple como una carpeta escrita a mano o un Google Doc, pero este caso construye un sitio de documentación con búsqueda usando Astro Starlight, un repositorio git y Cloudflare Pages
- La familia puede encontrar la información necesaria en un solo lugar, y para el siguiente propietario incluso entregar solo los archivos Markdown originales es muchísimo mejor que no dejar ningún registro
La casa también necesita un manual de usuario
- Durante el proceso de ser propietario por primera vez, hay muchos momentos en los que no es fácil verificar de inmediato la información básica de la casa
- Estas fueron algunas de las preguntas que realmente surgieron
- Cuándo se instaló la alfombra
- Cómo cerrar la llave principal de agua
- Cómo está configurado el sistema de riego
- Dónde están los aspersores
- Cuál es el modelo del lavavajillas y dónde está su manual de usuario
- Por qué la presión del agua es alta
- Qué empresa se encarga del alcantarillado
- Cómo están divididos los circuitos eléctricos dentro de la casa
- Si hay cableado de red
- Cuál es exactamente el color de la pintura
- Qué modelo de filtro HVAC hay que comprar
- La mayoría de las preguntas no tenían respuesta, o hubo que investigarlas y hacer ingeniería inversa por cuenta propia
- Reunir esta información la convierte, como una buena documentación de software, en una base de conocimiento a la que la familia puede recurrir cuando la necesite
Estructurar la documentación de la casa con Diátaxis
- A la documentación de la casa también se le puede aplicar Diátaxis, un framework de documentación técnica
- Diátaxis divide la documentación en cuatro modos
- Tutoriales
- Guías prácticas
- Referencia técnica
- Explicaciones
- Si las preguntas sobre la casa también se organizan según estos tipos, resulta más fácil encontrar y distinguir entre “qué hay que hacer” y “por qué”
Dejar el historial de la casa con un registro de cambios
- Como las cuatro categorías de Diátaxis por sí solas no bastaban para reflejar todos los cambios de una casa a lo largo del tiempo, se añadió una página de registro de cambios
- Aunque no se pueda responder a todas las preguntas del pasado, sí se pueden registrar los cambios importantes ocurridos durante el periodo de propiedad
- El registro de cambios incluye elementos como
- Reparaciones de plomería y su costo
- Actualizaciones y cambios en el sistema de riego
- Instalación de alfombra
- Remodelaciones
- Esto permite responder con más facilidad preguntas como “cuándo se volvió a poner esta alfombra, cuánta superficie se necesitó y cuánto costó”
La implementación puede ir desde una carpeta hasta un sitio web
- La documentación de la casa no tiene por qué construirse con un stack técnico complejo
- Una carpeta con notas escritas a mano
- Un Google Doc
- Un canal de YouTube con videos cortos
- Un sitio web consultable desde el teléfono
- Este sitio de documentación de la casa fue implementado con Astro Starlight
- Los documentos se guardan en un repositorio git dedicado a la casa, y se configuró compilación y despliegue automáticos con Cloudflare Pages
- Ese mismo repositorio git también se usa como lugar para guardar otros documentos importantes relacionados con la casa
Materiales que pueden guardarse junto con el repositorio
- La estructura de directorios presentada muestra el alcance de los materiales que pueden entrar en un repositorio de documentación de la casa
- En el repositorio pueden guardarse archivos como
- Contratos y documentos de cierre
- Diagramas como planos, dibujos de la oficina y wireframes del patio
- Archivos del sitio de documentación basado en Astro Starlight
- Documentos financieros
- Guía para invitados e información de Wi‑Fi
- Reportes de inspección de la vivienda
- Pólizas de seguro
- Documentos de impuesto predial
- Documentos relacionados con el arrendamiento de internet
- Dentro del sitio de documentación pueden incluirse secciones como registro de cambios, guías, introducción y documentos de referencia
Valor para la familia y para el siguiente propietario
- La documentación de la casa se convierte en un lugar único para que la familia encuentre información y mejora la calidad de vida
- La página de referencia del sistema de riego se usa con frecuencia para entender cómo funciona el sistema
- La página de referencia de manuales de usuario reúne enlaces a manuales en PDF o web de electrodomésticos y equipos electrónicos
- Cuando hace falta limpiar el lavavajillas de forma periódica, se puede acceder al manual en unos pocos clics sin volver a buscar el número de modelo ni hacer búsquedas otra vez
- La guía práctica para cerrar la llave principal de agua da tranquilidad en situaciones de emergencia
- El registro de cambios facilita verificar cuándo se hizo un trabajo específico y cuánto costó
- Aunque el siguiente propietario no quiera un stack técnico complejo, compartir aunque sea los archivos Markdown de texto plano usados para generar el sitio sigue siendo muchísimo mejor que no dejar ningún registro
1 comentarios
Opiniones de Hacker News
Le pasó a un amigo mío. Vivía en una casa vieja y durante la pandemia estuvo haciendo un sinfín de proyectos de reparación; a menudo hacía transmisiones en vivo de la remodelación por las noches para conectar con la gente.
Un día, al arrancar una pared del baño, encontró entre los muros un portapapeles con una nota pegada. Empezó a leerla y se puso a llorar. Era una lista de cableado e instalaciones escrita en los años 70, y en la primera página había una nota que decía: “Las reparaciones son difíciles y a veces solitarias, pero sigue adelante; algún día valdrá la pena”.
En un momento especialmente solitario de la pandemia, encontró justo cuando lo necesitaba documentación y palabras de ánimo que alguien había dejado 50 años atrás. Fue un momento realmente hermoso.
Eran cartas cálidas y puras entre familiares que se habían ido a California y familiares que se habían quedado por Oklahoma, y mi tío dice que se le hace un nudo en la garganta cada vez que las lee.
En Amélie, al enterarse de la muerte de la princesa Diana, se le cae el tapón de un perfume, golpea un azulejo de la pared y descubre una caja metálica con objetos de la infancia de un niño que había vivido en ese departamento décadas antes.
https://en.wikipedia.org/wiki/Am%C3%A9lie
En Being John Malkovich, Craig descubre una pequeña puerta oculta mientras archiva documentos y, al meterse por un túnel, entra en la conciencia del actor John Malkovich.
https://en.wikipedia.org/wiki/Being_John_Malkovich
En A Ghost Story, una mujer identificada como “M” le cuenta a su esposo músico, “C”, que cuando era niña se mudaba con frecuencia y solía esconder pequeñas notas en cada lugar donde vivía.
https://en.wikipedia.org/wiki/A_Ghost_Story
Mientras toda la casa estaba entre la demolición y la reconstrucción, dejé completamente arreglado el cuarto más pequeño, de 2×2 metros, como refugio, y gracias a ese cuarto pude mantener la cordura.
La mayoría de las vigas del piso se habían desplomado o podrido y hubo que reemplazarlas; en un momento aquello era casi un espacio vacío con solo el techo y los puntales de las paredes. Habría sido más rápido y mejor tirarlo todo y construir de nuevo, pero me propuse mantener el exterior sin cambios visibles, salvo por agregar una ventana inclinada en el plano del techo.
Después hice dos obras grandes más en otras casas, pero mi entusiasmo por este tipo de trabajos ya está casi agotado.
En mi casa anterior había hecho durante años automatización de hogar inteligente, y dejé una carpeta con instrucciones claras para todo, recibos de mejoras, garantías, códigos QR para descargar apps, mapa del terreno, planos, y una lista de contactos de reparadores.
También hice videos cortos de YouTube sobre cómo cerrar el agua, cortar las llaves exteriores y los aspersores, emparejar dispositivos, etc. Le dediqué decenas de horas y sentía la satisfacción de entregar la casa “con traspaso cálido”.
Pero el nuevo dueño vendió la casa dos años después, y al ver las fotos del anuncio noté que habían arrancado la mayoría de los dispositivos inteligentes y remodelado todo de forma bastante torpe. Los videos de YouTube tenían 0 vistas, y parecía muy poco probable que alguna vez hubieran mirado la carpeta que les dejé.
No pienso volver a dedicar tanto esfuerzo a documentar una casa; ahora solo dejo la documentación suficiente para que se entienda lo que hice.
En la práctica, no compro cosas anunciadas como “únicas en el mundo”. Aunque se vean geniales, sé que son un problema de mantener o deshacerse de ellas.
Creo que las instalaciones llamativas y sofisticadas no suman valor, sino que lo reducen, porque aumentan el trabajo de desmontarlas. Preferiría una casa con una cocina básica de IKEA: es más fácil de reemplazar y, según el caso, incluso cómoda para usar tal cual.
Era un material de cientos de páginas que incluía no solo los defectos encontrados, sino también reparaciones recomendadas, un calendario de mantenimiento continuo, fotos de la ubicación de las llaves de corte de agua, algunos videos y hasta una inspección con cámara de la tubería de desagüe.
Empecé a actualizarla con lo que agregué o cambié, pero creo que cuando llegue el momento de vender será más fácil simplemente contratar otra inspección. Eso sí, no había dispositivos inteligentes; si los hubiera habido, quizá habría costado más.
Piensan que una puerta podría trabarse, que podría entrar un intruso, o que durante un viaje la calefacción podría quedarse durante semanas calentando de más o de menos, así que prefieren no meterse en eso.
Podría arreglármelas con un simple indicador de flotador, pero no había razón para no usar un sensor hidrostático de alta precisión, esp32, influxdb, grafana, spring, keycloak y mysql corriendo en AWS.
Eso sí, si vendiera la casa, probablemente lo quitaría yo mismo para no recibir llamadas de soporte.
Yo también probablemente quitaría la mayoría de los dispositivos inteligentes que heredara, o al menos los volvería a flashear con firmware open source.
Otra regla importante que aprendí es que, aunque se caigan el Wi-Fi, el gateway, HomeAssistant o algunos sensores, la casa debe seguir funcionando con normalidad como una casa tonta.
Hay muchas historias de que, aunque se haga documentación, al final termina abandonada, pero también hay casos en sentido contrario.
Compré una casa que había quedado vacía después de un divorcio; los dos dueños anteriores ya se habían mudado hacía meses, así que traté casi siempre solo con el agente inmobiliario.
Dentro de la casa había una tarjeta de “felicitaciones por su nueva casa”, una botella de vino espumoso y una carpeta con todo sobre la casa. Incluía planos arquitectónicos, planos actualizados de las modificaciones, la ubicación de todos los cables y conexiones, manuales de equipos, facturas y garantías, un dibujo a mano de la distribución de las plantas del jardín e incluso enlaces para el cuidado de plantas exóticas.
Gracias a lo ordenado que lo dejó el dueño anterior, cada vez que hago trabajos de cableado o alguna obra menor, los planos exactos me ahorran muchísimo tiempo, y todavía se lo agradezco.
Etiqueté por habitación por dónde pasaban las tuberías y los cables, y pienso entregarlo algún día si la vendo. No entiendo por qué las constructoras no entregan de forma predeterminada un set de fotos del interior de las paredes así; en la práctica fue muy útil.
Tengo un montón de carpetas para distintos usos.
Después de mi divorcio en 2018 vendí la casa de North Seattle. La había comprado en 2004, cuando trabajaba en Microsoft, y allí crié a mi hijo.
También construí yo mismo un horno de ladrillo de 8×8×8 pies para pizzas y pan, y alquilé una excavadora durante una semana para cavar alrededor de toda la casa e instalar un drenaje perimetral de cimentación a 12 pies de profundidad, registros de limpieza cada 20 pies, tuberías de agua pex de 2 pulgadas y líneas de riego de pvc de 1 pulgada a 3 pies de profundidad. También destripé y remodelé por completo el sótano.
En una carpeta de 3 pulgadas dejé todo: las líneas de riego, el drenaje de cimentación, el sistema de recirculación por gravedad, el cableado eléctrico, fotos del proyecto de seis meses del horno de ladrillo e incluso cómo moverlo si hacía falta.
Cuando vendí la casa, volé de regreso para entregársela personalmente al nuevo dueño y explicarle todo, pero no pareció mostrar mucho interés ni agradecimiento.
Hace unos meses volví a Seattle, y mi hijo de 17 años, que nació en esa casa, fue a preguntar si podía mirar el exterior. Lo miraron como si fuera un tipo raro, pero le dieron permiso. Cuando volvió me dijo que habían demolido el horno de ladrillo, que yo había pensado que duraría más que yo.
Soñaba con que algún día, dentro de 100 años, unos niños comieran pizza salida de ese horno sin saber quién lo había construido. Aun así, la próxima vez que tenga una casa volveré a documentarlo todo; solo que seré más exigente con a quién se la vendo.
Fuiste tú quien construyó y disfrutó el horno y luego decidió vender la casa; no entiendo por qué quieres decidir cómo deben usarla los dueños posteriores. Si querías dejar el horno de pizza como una especie de monumento personal, tendrías que haberte quedado con la casa.
Ese tipo de pensamiento estanca los barrios y hace que los vecinos intenten controlar el aspecto y el ambiente de la zona. Al final termina en regulaciones que impiden construcciones nuevas o hasta dictan el color de la pintura.
Los espacios históricamente importantes pueden preservarse, pero es problemático imponer a la mayoría cosas menores que solo le importan a unos pocos. Y, al contrario, a veces se dejan pudrir lugares con verdadero significado histórico.
https://www.theguardian.com/us-news/2018/mar/30/rosa-parks-h...
No puedes esperar que los nuevos dueños compartan los intereses de los anteriores. Puede que sean gluten-free o que no les interese en absoluto hornear. Es difícil esperar que mantengan 64 pies cuadrados del patio como un monumento a algo que no significa nada para su familia.
Entiendo el apego a una casa y el deseo de que quede en buenas manos, pero no debería existir la expectativa de que no la adapten a su nueva familia.
Pero ese deseo no encaja muy bien con la cultura residencial estadounidense, que trata las casas como mercancías que se compran y venden con frecuencia.
Mis padres también vendieron su casa hace unos años, y mi padre suele decir que la extraña y que el nuevo dueño está haciendo cambios horribles, pero eso no cambia el hecho de que yo crecí en esa casa y pasé buenos momentos allí. Ahora mi padre tiene la oportunidad de crear nuevos recuerdos con su nieta en su nueva casa.
En realidad estaba roto, pero le cambié la bomba y los sensores, lo limpié bien y lo disfrutamos durante 8 años. Cuando vendimos la casa, le dijimos al comprador que, si no lo quería, podíamos negociar llevárnoslo a nuestra nueva casa, pero compró la casa sin responder nada.
Un vecino me contó que, apenas se mudaron, destrozaron el jacuzzi y lo mandaron al basurero. Es cierto que era su casa, pero algunas personas son demasiado derrochadoras.
Se ven algunos comentarios diciendo que la documentación entregada no fue apreciada, pero también hay otra perspectiva. Compré mi primera casa, una que necesitaba arreglos, y los habitantes anteriores eran mis padres, que habían fallecido; lo que quedó fue una bolsa de plástico con manuales de electrodomésticos, recibos viejos y, lo más importante, una tabla de historial de reparaciones y reemplazos.
Tenía anotadas las fechas, qué se había renovado y cuánto había costado, así que no tuve que adivinar qué tan viejos eran el aire acondicionado o la caldera, cuándo se había remodelado el sótano, ni cuánta alfombra se había pedido para el dormitorio secundario. Como propietario primerizo, me ayudó muchísimo y lo agradecí mucho.
En la caldera anoté con marcador permanente la fecha de instalación y las fechas de mantenimiento; en la tubería principal de desagüe anoté cuándo fue la última limpieza, quién la hizo y dónde estaba la obstrucción.
Tener una impresora industrial de etiquetas facilita mucho este tipo de trabajo.
Me pareció algo muy adulto y poco común, pero quizá sea más habitual de lo que pensaba.
Cuando construí mi casa, hice un escaneo Matterport antes y después de instalar el panel de yeso, y fue una de las mejores decisiones que tomé. Se siente como tener visión de rayos X para ver las paredes.
Es útil para ver por dónde pasan los cables, cuántos montantes hay entre las ventanas al montar una TV, y para revisar varios temas eléctricos, de climatización y de plomería. Al principio lo usaba todas las semanas y, ahora que ya estoy instalado, todavía lo uso más o menos una vez cada dos meses.
También recomiendo la etiquetadora de cables Dymo Rhino 5200 y tubos termocontraíbles. Si imprimes etiquetas en tubo termocontraíble y las colocas en los cables, nunca más te confundes sobre a dónde va cada uno. También sirve muy bien para arneses de cableado de vehículos: https://www.youtube.com/watch?v=-LcUQeTzIo4&t=66s
Eso sí, recomiendo la 5200: https://www.amazon.com/DYMO-Industrial-RHINO-Label-1755749/d... - no es enlace de afiliado
Este enlace tiene la etiqueta de afiliado pmg097-20.
La dirección sin enlace de afiliado es esta: https://www.amazon.com/DYMO-Authentic-Industrial-RhinoPro-18...
Cada vez que compro una casa, compro una libreta Moleskine pequeña y la uso como cuaderno de la casa. Anoto compras importantes de electrodomésticos, fechas y números de serie, una copia local de la información de los interruptores, fechas y costos de remodelaciones, y planos de las habitaciones con medidas.
También anoto los códigos y acabados de pintura por habitación, moldura y techo; cuando haces algo como reparar paneles de yeso y las etiquetas de las latas de pintura sobrante están hechas un desastre, es realmente útil.
También hice cuadernos separados para la mudanza y la compra, con el agente de préstamos, el agente inmobiliario, el inspector, citas, proveedores, fechas clave, listas de verificación de entrada y salida, listas de cosas para guardar, tirar o donar, gastos, documentos para oficinas públicas y direcciones y teléfonos.
Tener toda esa información al alcance de la mano es bastante poderoso.
Tengo una RV, y vino con un manual grueso del chasis y otro manual para todo el equipo instalado de fábrica. No soy el primer dueño, y mi hermano, que es militar y muy meticuloso, dejó documentación de todos los electrodomésticos y dispositivos que instaló en la RV.
Desde que pasó a ser mía, he agradecido constantemente esa documentación, y yo también documenté de la misma forma el Wi-Fi, la red, el cobertizo de herramientas, el escritorio de altura ajustable, el horno, la plomería, etc.
Durante los últimos tres años, más o menos, apliqué el mismo principio a la casa, y mantengo dos carpetas gruesas de anillos: una para el “chasis” de la casa y otra para el equipo dentro de la casa.
Anoté cómo reiniciar internet, cómo “reiniciar” el calentador de agua, cómo cambiar el filtro del aire acondicionado, qué números de modelo de filtros hacen falta, e incluso por qué el aire acondicionado no tiene retorno de aire, para el próximo dueño y para mí mismo. También incluye el historial de mantenimiento de un tramo de tubería de drenaje que colapsó y fue reemplazado, cómo acceder a las bocas de limpieza, por dónde pasan los cables dentro de las paredes, los interruptores cuidadosamente etiquetados y los códigos de pintura por pared.
Primero lo anoto en OneNote para que se pueda buscar, y después lo pongo en una carpeta de 3 anillos con secciones por zona. No intentes hervir el océano de una sola vez; si lo haces por etapas no toma tanto tiempo, y lo agradecerás durante años. Una casa tampoco cambia tan rápido como el software desarrollado por un equipo.
Es excelente.
Bastaría con que permitiera llenar campos en línea y generara un PDF.
Es un excelente consejo y, si tú eres la persona de la familia que suele encargarse de estas cosas, es una buena forma de prepararse ante una muerte inesperada o una incapacidad.
Pero las herramientas o medios deben ser algo con lo que la gente común esté familiarizada. Hay que asumir que la persona que tendrá que leerlo solo conoce git como algo parecido al “git ’er done!” de Larry the Cable Guy.
Para el manual del lavavajillas y los pernos de transporte basta con pegarlos con cinta arriba del aparato. Para cosas como la calefacción, basta con pegar una hoja plastificada en la tubería.
Si te gusta lo digital, sería mejor poner un documento .docx en una carpeta compartida en línea; probablemente dentro de 40 años todavía sea posible encontrar una herramienta para abrirlo y editarlo.
Para algunas personas, crear una pila digital será el objetivo en sí, pero me cuesta creer que esa documentación sobreviva décadas.
Por ejemplo, en el tablero eléctrico de nuestra casa las etiquetas de los interruptores están escritas con marcador permanente, y también dejamos notas en el lugar sobre particularidades de los electrodomésticos o tamaños de filtros. La información se ve justo donde se necesita y no se puede borrar ni quedar escondida detrás de un muro de pago.
La gente del sector tecnológico a veces complica demasiado las cosas.
Vivo en la casa donde crecí. Yo mismo diseñé el segundo piso que mi padre construyó como ampliación.
Mi padre conoce la estructura de esta casa de una manera que yo jamás podré conocer, y aunque ahora vive a 50 millas de distancia, sigue siendo un recurso extraordinario sobre la casa.
Hace unos años, cuando quise tender cat5 hasta la oficina del segundo piso, me dijo: “Solo haz un agujero en el piso de esa esquina. Hay un espacio vacío que va desde el segundo piso hasta el sótano”, y efectivamente era así.
Lo que quiero son los planos que están en la cabeza de mi padre.
Ahora, cuando quiero hacer algo, es muy útil porque sé exactamente cómo es el entramado, y por dónde pasan las tuberías de agua, los desagües y los cables.
Probablemente, cada vez que le preguntas algo así, tu padre se ilumina por dentro.