Inside Macintosh es la documentación para desarrolladores publicada por Apple Computer , que documenta las API y la arquitectura del Mac OS clásico de Macintosh .
La primera documentación de Inside Macintosh , para el primer Macintosh , se distribuyó en dos grandes carpetas con páginas fotocopiadas perforadas con tres agujeros . Cada pocos meses, se distribuyeron secciones actualizadas para su inserción en las carpetas. Algunas de las secciones originales fueron escritas por los primeros miembros del grupo Macintosh, incluidos Chris Espinosa y Joanna Hoffman. Todos estos volúmenes fueron diseñados para ser leídos juntos, sin repetir información. [1]
En julio de 1982, contrataron a Caroline Rose para hacerse cargo de la documentación del software, mientras que Bradley Hacker se centró en documentar el hardware. Además de ser la escritora principal, Rose editó los volúmenes I a III y fue la supervisora del proyecto. En 1984, otros escritores se unieron al esfuerzo, incluidos Robert Anders, Mark Metzler, Kate Withey, Steve Chernicoff, Andy Averill y Brent Davis.
Debido a numerosos cambios de software de última hora, la versión oficial que publicará Addison-Wesley se retrasó. Mientras tanto, en abril de 1985 estuvo disponible una edición promocional de 25 dólares (conocida como "edición de guía telefónica" porque fue publicada por la editorial de guías telefónicas Lakeside Press ).
Addison-Wesley publicó los volúmenes I a III en julio de 1985 en dos formatos: tres libros de bolsillo separados y un libro de tapa dura que combina los tres volúmenes. Es la documentación técnica oficial para el Macintosh original, el Macintosh 512K ("Fat Mac") y el Macintosh XL .
Desde el Volumen IV, la autoría se atribuye únicamente a Apple Computer en general. El Volumen IV (octubre de 1986) documenta los cambios en el software del sistema en Macintosh Plus , que se introdujo en enero de 1986. El Volumen V (febrero de 1988) documenta Macintosh II y Macintosh SE , que se introdujeron en 1987. Analiza Color QuickDraw , el hardware Mac II y Mac SE, y otros componentes de software nuevos. El Volumen VI (abril de 1991) describe el Sistema 7 . Con 32 capítulos, es más grueso que los tres primeros volúmenes juntos.
Poco después de la publicación del Volumen VI, Apple renovó toda la serie Inside Macintosh , dividiéndola en volúmenes según el área funcional analizada, en lugar de modelos o capacidades de máquina específicos. De esta forma, la serie es mucho más coherente y una referencia mucho mejor para los programadores. A medida que se añadieron nuevas funciones al Mac OS clásico , se pudieron escribir nuevos volúmenes sin invalidar los publicados anteriormente, a diferencia de la primera serie, que se volvió cada vez más obsoleta con el tiempo.
A finales de la década de 1990, Apple dejó de publicar Inside Macintosh como libro impreso, en lugar de hacerlo como CD-ROM al menos desde 1994, [2] y en línea. Desde entonces, la variante en CD se ha ido eliminando, aunque los desarrolladores de Apple todavía reciben documentación en línea como parte de los CD para desarrolladores. En su formato en línea, la información es mucho más fácil de mantener, pero algunos desarrolladores aún prefieren un formato impreso.
Inside Macintosh cubre sólo el Mac OS clásico y se introdujo un nuevo conjunto de documentación para Mac OS X. Inicialmente, esta documentación incluye solo la Especificación de Carbon que identifica las API en Carbon y la documentación de Cocoa heredada de OpenStep . Más tarde, la Especificación de Carbono se refactorizó en Carbon Reference, que en realidad documenta las API y toma gran parte del contenido de Inside Macintosh . La referencia de carbono y la referencia de cacao están agrupadas en la biblioteca de referencia de ADC .
Las reacciones a los volúmenes I a III fueron mixtas. Muchos elogiaron la documentación por su claridad, minuciosidad y coherencia, y otros no estuvieron de acuerdo especialmente con la falta de código de muestra.
En la edición del 27 de enero de 1986 de InfoWorld , el columnista John C. Dvorak escribió que lo más destacado de la Conferencia Appleworld , para muchos, fue la publicación de Addison-Wesley de Inside Macintosh . "Cuesta $75 y vale cada centavo. Te dice todo lo que nunca quisiste saber sobre Macintosh, algo imprescindible para cualquier desarrollador". [3] También en 1986, Inside Macintosh Volumes I–III ganó un Premio al Logro en la competencia del Norte de California de la Sociedad de Comunicación Técnica. En 1988, el desarrollador de software y columnista Stan Krute escribió: "Si los Pulitzers tuvieran una categoría de escritura técnica, Inside Mac ganaría un premio. [Sus escritores] nos han brindado la visión más completa jamás vista sobre un sistema cibernético complejo". [4]
Bruce F. Webster en Byte de diciembre de 1985 describió Inside Macintosh como "infame, costoso y oscuro [pero] para cualquiera que quiera hacer mucho con Mac [...] la única fuente de información real [impresa]". Citó a Kathe Spracklen, desarrolladora de Sargon , diciendo que el libro "consta de 25 capítulos, cada uno de los cuales requiere que comprendas los otros 24 antes de leerlo". [5] Un artículo sobre la GUI de Mac escrito por Dog Cow cita a Robert C. Platt diciendo: "La mejor guía para las ROM de Mac es Inside Macintosh . Desafortunadamente, Inside Macintosh es también la documentación más incomprensible jamás escrita". [1]