October 2024
Intermediate to advanced
270 pages
8h 13m
Spanish
Content preview from 97 cosas que todo programador Java debe saber
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Capítulo 3. Aumentar Javadoc con AsciiDoc
Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: translation-feedback@oreilly.com
James Elliott
Los desarrolladores de Java ya conocen Javadoc. Los que llevan mucho tiempo en esto recuerdan lo transformador que fue, ya que Java se convirtió en el primer lenguaje de uso generalizado en integrar un generador de documentación directamente en el compilador y en la cadena de herramientas estándar. La explosión resultante de documentación de API (aunque no siempre sea grandiosa o pulida) nos ha beneficiado enormemente a todos, y la tendencia se ha extendido a muchos otros lenguajes. Como informó James Gosling, Javadoc fue inicialmente controvertido porque "un buen escritor técnico podría hacer un trabajo mucho mejor", pero hay muchas más API que escritores técnicos para documentarlas, y el valor de tener algo disponible universalmente ha quedado bien establecido.
Sin embargo, a veces necesitas algo más que la documentación de la API, mucho más de lo que cabe en las páginas de resumen de paquetes y proyectos que ofrece Javadoc. Guías y recorridos orientados al usuario final, antecedentes detallados sobre arquitectura y teoría, explicaciones sobre cómo encajar múltiples componentes... nada de esto cabe cómodamente en Javadoc.
Entonces, ¿qué podemos utilizar para satisfacer estas otras necesidades? Las respuestas ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access
More than 5,000 organizations count on O’Reilly
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.Julian F.
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.Addison B.
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.Amir M.
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.