Darles a las personas algo a lo que puedan enlazar para hablar

 (simonwillison.net)
1 puntos por GN⁺ 2024-07-14 | 1 comentarios | Compartir por WhatsApp
  • Si quieres que la gente entienda y comparta una función de un proyecto o producto, antes de explicar lo mismo una y otra vez necesitas una página web dedicada
  • Aunque ChatGPT Code Interpreter es una función potente, el nombre en la documentación oficial y su capacidad de ser encontrada han sido inestables, por lo que las explicaciones creadas por otras personas terminan siendo enlaces más útiles
  • Los casos de Claude Artifacts y GitHub Codespaces·Copilot muestran que, cuando una función se convierte en un destino enlazable, compartirla y explicarla se vuelve más fácil
  • Cuando un concepto queda organizado en una página aparte, como Boring Technology de Dan McKinley, alguien que lo escucha por primera vez puede ponerse en contexto rápidamente con un solo enlace
  • El valor de una página dedicada no se limita a aparecer en búsquedas: también evita tener que repetir la misma explicación en conversaciones en la web

Por qué hace falta una página enlazable

  • Todo aquello que quieres que otras personas entiendan y comenten —como un proyecto, una idea o una función de producto— necesita una página enlazable
  • Los hipervínculos son el medio básico para ampliar conversaciones en la web, porque permiten conectar con una explicación definitiva sin tener que escribirla de nuevo cada vez
  • Si no hay una página dedicada, la atención y el tráfico de búsqueda pueden irse hacia explicaciones creadas por otras personas o páginas que se adueñaron de las palabras de búsqueda

El problema de descubrimiento de ChatGPT Code Interpreter

  • ChatGPT Code Interpreter es una función que permite que ChatGPT escriba y ejecute código Python durante el proceso de respuesta
  • La función en sí es potente, pero si no sabes cómo activarla mediante un prompt, es difícil darte cuenta de que existe
  • Si buscas Code Interpreter en el sitio de OpenAI, aparecen documentación técnica sobre una función de la API o un hilo antiguo del foro, lo que genera confusión
  • Al presentar esta función, la página de la etiqueta code-interpreter resulta ser un enlace más útil que una página oficial de OpenAI
  • Más tarde se confirmó que sí había documentación real, pero el título era Data analysis with ChatGPT y el término “Code Interpreter” no aparecía en la página, por lo que era difícil encontrarla
  • OpenAI ha seguido cambiando el nombre de esta función entre Code Interpreter, Advanced Data Analysis y Data analysis with ChatGPT

Buenos ejemplos de páginas de funciones

  • La función Artifacts de Claude al menos tiene una página de ayuda fácil de encontrar
  • Sin embargo, el artículo de anuncio de Artifacts se compartió junto con el anuncio de Claude 3.5 Sonnet, así que no se percibe fácilmente como un destino de enlace claro y exclusivo para Artifacts
  • GitHub ofrece páginas de aterrizaje separadas para cada función
  • Cuando una función tiene una página dedicada aparte, se crea un punto de referencia para explicarla al enlazarla y compartirla

Boring Technology: un caso en el que un concepto se volvió sitio web

  • Dan McKinley acuñó el término Boring Technology en el ensayo de 2015 Choose Boring Technology
  • La idea central es que la capacidad de un equipo de desarrollo para resolver problemas nuevos es limitada, así que esa capacidad debe usarse en las partes que hacen único al producto
  • En las demás áreas, se debería elegir la tecnología más aburrida y conocida, cuyos errores y límites ya se hayan entendido y discutido durante mucho tiempo en línea
  • Esta idea también está organizada como sitio web en boringtechnology.club
  • Cuando alguien no conoce el término, compartir un solo enlace le permite ponerse en contexto en pocos minutos

Las ideas personales también necesitan páginas que se puedan compartir

  • Ideas como baked data, git scraping y prompt injection también están organizadas en páginas que se pueden compartir con frecuencia
  • Sin embargo, si no se asegura incluso un dominio separado, puede debilitarse el mensaje de “esta es la página central a la que hay que enlazar”
  • Un destino de enlace claro aumenta la capacidad de una idea de compartirse y de generar conversación

Un valor que funciona más en la conversación que en el SEO

  • Uno de los propósitos evidentes de una página dedicada es el SEO
    • Cuando los usuarios busquen una función del producto, deberían llegar al sitio propio, no a una página creada por otra persona
  • El valor más grande aparece en las conversaciones
    • Al explicar un concepto, en lugar de volver a escribir un párrafo, puedes compartir un enlace que contenga la explicación definitiva
  • Si quieres que la gente entienda y discuta una idea, un proyecto o una función, deberías crear una página web acorde para ello

Lecturas relacionadas

1 comentarios

 
GN⁺ 2024-07-14
Opiniones en Hacker News

  • rsync.net es un servicio que hace bien este tipo de cosas. Por ejemplo, no recuerdo haber visto en otros servicios algo como una página del CEO.
    No sé si sea realmente útil, y nunca tuve que hacerle llegar nada al CEO, pero ni siquiera soy cliente y, apenas leí este artículo, esa página fue lo primero que me vino a la mente.
    [1]: https://www.rsync.net/products/ceopage.html

    • Algunas conferencias tienen una página de “por qué tu empleado debería asistir a KimchiBurgerConf”.
      Es una página diseñada para que el asistente pueda enviársela directamente a su jefe, sin tener que inventarse por su cuenta una justificación laboral convincente.

  • A estas alturas uno pensaría que OpenAI ya habría contratado redactores de documentación técnica, pero según LinkedIn parece que no. Así que tampoco sorprende mucho que la documentación esté en tan mal estado.
    No entiendo por qué no contratan un rol dedicado a documentación. O no lo consideran importante, o priorizan fríamente el crecimiento por encima de la documentación; sea cual sea la razón, al final se están perjudicando a sí mismos.

    • La documentación de OpenAI ha mejorado un poco últimamente, pero hoy está muy por detrás de Anthropic. La guía de prompts de Anthropic es de verdad de lo mejor que he visto: https://docs.anthropic.com/en/docs/build-with-claude/prompt-...
    • Contratar redactores de documentación técnica sería como admitir una ventaja humana en el área de documentación técnica. Independientemente del impacto en los ingenieros y usuarios, parece que usar documentación generada por GPT se ve mejor desde afuera.

  • El artículo hace referencia a https://boringtechnology.club/, un excelente deck de diapositivas sobre reservar el esfuerzo de innovación solo para las soluciones realmente únicas.
    Para todo lo demás hay que irse lo más posible por tecnología aburrida. He visto demasiadas veces equipos de desarrollo intentando innovar hasta en lo más bajo de la pila, y perdiendo de vista qué valor entregan realmente. Quiero grabarme ese deck de diapositivas en mi visión del mundo.

  • Otro buen artículo de Simon. Anoche incorporé este concepto tal cual en un proyecto nuevo. Quería mostrar evidencia de que Google Gemini App censura yt-dlp, pero la API de Gemini no, y al mismo tiempo quería crear vías de entrada al proyecto y también esas razones de negocio de las que habla Simon.
    https://topicalsource.dev/chat/84a0d6dd-f66f-4f12-af17-5e99c...
    Además usé localStorage para guardar una lista de chats públicos visitados. Así, cuando vuelves, puedes ver otros chats que habías leído, y también es más fácil encontrarlos que revisar el historial de mensajes para ver de dónde recibiste el enlace original.

    • Por cierto, mejor no abrir el enlace de YouTube del ejemplo. Gemini trajo un meme troll muy conocido.

  • Los enlaces muertos son lo peor. ¿Alguien no puede crear una extensión de navegador que use GPT para alucinar y reconstruir el sitio web de un enlace muerto?

    • Puede que ya haya varias generaciones que no sepan que la pudrición de enlaces no ocurre solo con URLs “internas”, como enlaces a imágenes de Discord, sino con todos los enlaces.
      Los artistas simplemente enlazan sitios de redes sociales, pero las cuentas pueden ser suspendidas y los nombres de usuario pueden cambiar. Los desarrolladores también “enlazan” dependencias sin considerar que el repositorio puede desaparecer; si nadie hizo una copia de respaldo, también puede desaparecer el código fuente de esa versión; una versión de paquete puede ser eliminada del registro, o la documentación en línea de una dependencia puede desaparecer.
      [1]: Simplemente agregar nombre+versión en un archivo de manifiesto y olvidarse para siempre. Incluso si agregas caché, no es un mirror de verdad, y mucho menos una forma de poder compilar tú mismo las dependencias en caso de desastre.
    • https://websim.ai/
    • También sería interesante un método de compresión que proporcione solo la información suficiente para que una versión fija de un LLM pueda generar una página que satisfaga el objetivo del autor.
      Si la gente describiera una por una cómo se veía antes esa página, o rastreara la web buscando pistas, sería una idea bastante interesante. Incluso podríamos traer de vuelta los banners de “en construcción”.
    • Antes a eso se le llamaba imaginación. Parece que la perdimos en la era digital :3
    • No sé si como extensión de navegador, pero hay un sitio llamado websim AI que genera páginas falsas en tiempo real con un LLM. Honestamente funciona sorprendentemente bien.

  • Me gusta el blog de Simonw. Desde septiembre del año pasado leo su blog usando el intérprete de Python. Él dijo que empezó a hacerlo solo para crear aplicaciones completas sobre la marcha.
    Pero todavía no tengo claro cómo se hace. Pensé que habría una opción o botón fácil, pero no lo encontré. Podría haberme esforzado más para averiguarlo, pero si hubiera habido un enlace cómodo o un tutorial, creo que habría seguido usando GPT en vez de ignorarlo casi por completo.

  • En este contexto, el meme de respuesta a incidentes de Square sigue vivo en https://outage.party/

    • ¿Alguien puede dar contexto para quienes no estuvimos ahí en ese momento?

  • Odié muchísimo varios productos de Microsoft precisamente por esta razón. Productos que cambiaban de nombre, como VSTS/VSO/Dev Ops, o SharePoint eran especialmente horribles. Un deep link tenía 700 caracteres, con decenas de cadenas de consulta en base64 y rutas absurdas. Me volvía loco esa actitud de “¿cuál es el problema? Usen un acortador de URL, ¿no? Las URL son largas por naturaleza, no hay nada que hacer”.
    En 2014, una herramienta interna del equipo mostraba el estado de los recursos del sistema, y todos los recursos y estados estaban en una base de datos SQL. Pero la webapp era una SPA de antes de que existieran cosas como routers, y no actualizaba la URL ni soportaba deep links. Para enviar por email o mensajería el problema de un recurso específico, había que explicar: “Ve a la herramienta X, busca Y y haz clic en Z -> W -> M -> O -> K; ahí lo verás”. Me enfurecía que no pudiéramos simplemente compartir un estado profundamente anidado con un enlace como https://X.com/Y/Z/W/M/O/K. Lo planteé varias veces, pero solo recibí respuestas como “no es prioridad y tampoco es para tanto”.
    Una vez tuve la oportunidad de trabajar durante 2 semanas en algo que quería arreglar, y decidí crear una alternativa que soportara deep links. Además, hice que todos los deep links, al recibir el prefijo /api/, devolvieran el contenido como JSON. Fue un gran éxito en el equipo y en la empresa; aunque mi herramienta era mucho más simple y tenía menos funciones, el uso de la herramienta X cayó casi de la noche a la mañana. Al final, la mayoría de la gente quería una forma fácil de compartir enlaces más que una “SPA poderosa para profundizar e investigar”.
    Un mes después, el equipo de la herramienta X anunció con bombos y platillos por correo a toda la empresa que soportaba deep links. Pero consideraron que la función simple de devolver datos JSON con el prefijo /api/ no era importante. Cinco años después, la UI de mi herramienta ya se veía anticuada, pero el servicio real fue ascendido a servicio interno clave porque muchos equipos habían construido automatizaciones alrededor de las URL con prefijo /api/, y al final ese equipo tuvo que tomar el código y mantenerlo.

    • En entornos de oficina he visto muchos casos en los que la gente se conforma con usar las herramientas y los procedimientos establecidos tal cual, y no suele pensar que podrían ser mejores. Incluso si les preguntas, responden que están bien; no se dan cuenta hasta que les muestras algo mejor.
    • Una de las razones por las que React Server Components se sienten incómodos es que fomentan mezclar la API con la capa de presentación. Tienen ventajas, pero todos sabemos que la capa de presentación siempre falla al diseñarse para usuarios o casos de uso que aún no se han previsto.
    • ¿Qué es una SPA?

  • Como fan de Simonw, diría algo que todavía nadie señaló: otros ejemplos en los que Simon ofrece cosas que la gente puede enlazar también funcionan muy bien en HN: https://hn.algolia.com/?dateRange=all&page=0&prefix=true&que...
    Simon suele resumir con mucha rapidez novedades en curso que quienes están cerca del área de IA ya conocen, pero que el público más amplio todavía no. Hace que los hechos relevantes sean enlazables y accesibles rápidamente, permitiendo que también participen en la discusión personas más alejadas del tema.

  • Estoy de acuerdo con la frase “los hipervínculos son lo mejor de la Web”. Para ser precisos, son los hipervínculos y las URL.
    Las URL son la piedra angular de la Web. Permiten referenciar textos y otros recursos de una forma precisa, que aspiramos a que sea universal y duradera. Siempre me frustra ver que la gente no reconozca lo magnífico que es esto. Por ejemplo, cuando en vez de pegar un enlace en un mensaje dicen “busca esto en YouTube”. Darle a un texto un hogar web permanente también aumenta su visibilidad y reduce la necesidad de que el autor vuelva a escribir la misma idea.
    Ensayo clásico relacionado: Cool URIs don't change. [0][1]
    [0] https://www.w3.org/Provider/Style/URI
    [1] https://news.ycombinator.com/item?id=23865484

    • Dos propiedades poco aprovechadas de las URL son que se pueden crear casi infinitamente y que se puede declarar algo por adelantado.
      En la práctica, el efecto es este: si estás hablando con alguien o en una sesión de preguntas y respuestas de una presentación y quieres decir “sí, también pensamos en eso, y hay información relacionada en acmeinitiative.example.com/skub”, aunque todavía no hayas escrito el artículo /skub, puedes decidir en ese mismo momento que /skub será el identificador designado para ese texto. Lo escribes después y aparecerá ahí; quienes estén interesados podrán encontrarlo en esa URL cuando quieran. Lo mismo aplica a textos de otras personas o recursos externos: puedes crear al vuelo una URL dentro de tu propio espacio de nombres y, más tarde, cuando tengas tiempo, redirigirla al enlace original.
      He escuchado demasiadas grabaciones, podcasts, etc., con técnicos inteligentes que claramente poseen su propio dominio y aun así no usan este enfoque. Normalmente murmuran una descripción que quizá se pueda encontrar, o intentan recordar el título y lo dicen medio mal. Entonces todos los oyentes interesados tienen que gastar por separado su tiempo y atención para encontrarlo, y en conjunto se desperdicia una enorme cantidad de energía.
    • Los jardines amurallados están bloqueando cada vez más las URL.
      FB bloquea muchos sitios, incluso blogs aleatorios, con el pretexto de compartir contenido con copyright; reddit bloquea todos los .ru, varios sitios de archivo, enlaces de Telegram, etc. Twitter bloqueó algunas plataformas de blogs, y muchos sitios más pequeños también bloquean Discord. El bloqueo de Discord puede ser justificable, pero ojalá esta tendencia se convierta en una razón para que la gente se vaya de ahí.
    • Odio la expresión “búscalo”.
      Primero, de inmediato me despierta esa sensación turbia tipo AOL Keyword. Segundo, ignora por completo el concepto de burbuja de búsqueda. Aunque usemos las mismas palabras clave, los resultados que tú y yo recibimos pueden ser muy distintos. Tercero, si ya existen las URL y los hipervínculos, no hace falta hacerme trabajar de más. Si enlazas directamente, puedo ver exactamente a qué te referías sin tener que perderme entre innumerables videos de reacción.
    • Es fácil decir que hagan clic en https://youtu.be/dQw4w9WgXcQ, pero en medios solo de audio como una llamada telefónica o un podcast, ¿cómo transmites esa URL? No es fácil sin depender de un acortador de URL igualmente difícil de memorizar.
    • De verdad me gustaría que se cumpliera eso de que el autor no tenga que volver a escribir la misma idea.
      Pero a muchos sitios y servicios esto no les gusta, porque lo ven como una invasión de su territorio de atención. Si, como autor, enlazo una idea que ya expresé cuidadosamente en una entrada de blog o en un libro, el comentario puede ser eliminado o censurado por “promoción”. Últimamente, en HN, para evitar sanciones, termino más a menudo copiando y pegando mi propio texto original en lugar de dar un enlace para que el lector pueda explorar más a fondo. Hay una brecha clara entre la buena forma “académica” de difundir información que predicamos y la realidad de los sistemas que controlan la expresión.