=== Versioning ===

=== Versioning ===

The preface also contains a fable about the perception of the world evolved from acient Greek's over [[wikipedia:Newton|Newton]], [[wikipedia:Einstein|Einstein]] to today. The primary motivation to create such methaphore was to explain that one can even change rules over a time, but it is important to do that in a [[BackwardCompatibility|backward compatible]] way - e.g. in a way that nobody notices that the rules changed.

The preface also contains a fable about the perception of the world evolved from ancient Greek's over [[wikipedia:Newton|Newton]], [[wikipedia:Einstein|Einstein]] to today. The primary motivation to create such metaphor was to explain that one can even change rules over a time, but it is important to do that in a [[BackwardCompatibility|backward compatible]] way - e.g. in a way that nobody notices that the rules changed. Maybe the physics really changed between 17th and 19th century? Maybe the God was just trying to tease mankind?

=== Versioning ===

=== Versioning ===

The preface also contains a fable about the perception of the world evolved from acient Greek's over [[wikipedia:Newton|Newton], [[wikipedia:Einstein|Einstein]] to today. The primary motivation to create such methaphore was to explain that one can even change rules over a time, but it is important to do that in a [[BackwardCompatibility|backward compatible]] way - e.g. in a way that nobody notices that the rules changed.

The preface also contains a fable about the perception of the world evolved from acient Greek's over [[wikipedia:Newton|Newton]], [[wikipedia:Einstein|Einstein]] to today. The primary motivation to create such methaphore was to explain that one can even change rules over a time, but it is important to do that in a [[BackwardCompatibility|backward compatible]] way - e.g. in a way that nobody notices that the rules changed.

=== Versioning ===

=== Versioning ===

The preface also contains a fable about the perception of the world evolved from acient Greek's over [[wikipedia:Newton|Newton], [[wikipedia:Einstein|Einstein]] to today. The primary motivation to create such methaphore was to explain that one can even change rules over a time, but it is important to do that in a [[backwardcompatible]] way - e.g. in a way that nobody notices that the rules changed.

The preface also contains a fable about the perception of the world evolved from acient Greek's over [[wikipedia:Newton|Newton], [[wikipedia:Einstein|Einstein]] to today. The primary motivation to create such methaphore was to explain that one can even change rules over a time, but it is important to do that in a [[BackwardCompatibility|backward compatible]] way - e.g. in a way that nobody notices that the rules changed.

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of [[distributed development]]. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of [[distributed development]]. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

== [[Have You Ever Wondered]]...? ==

== [[Have You Ever Wondered]]...? ==

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of distributed development. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of [[distributed development]]. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

== Have You Ever Wondered...? ==

== [[Have You Ever Wondered]]...? ==

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of distributed development. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of distributed development. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

== Did You Ever Wondered...? ==

== Have You Ever Wondered...? ==

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of distributed development. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

Have you read many books about design? Have you read some? Do you think you know everything about proper design? Are you asking why bother with yet another design book? This ''prologue'' shows you that you should care. Most design books are written for "in-house" development, however with the rise of code reuse caused mostly by proliferation of various open source libraries and frameworks, we are entering world of distributed development. The new coding life style needs slightly different designing approach. After reading "prologue", you'll find out that you need [[TheAPIBook]] if you want to code software for the 21st century.

* I'd love to have one extra historical tidbit in the introduction somewhere: what's the origin of the term API? I first remember hearing it in the early 90's, but it's possibly older than that. I spent some time searching using Google, but came up empty-handed. Can you research this?

* I'd love to have one extra historical tidbit in the introduction somewhere: what's the origin of the term API? I first remember hearing it in the early 90's, but it's possibly older than that. I spent some time searching using Google, but came up empty-handed. Can you research this?

* (spelling) I'd prefer seeing a hyphen in the term "object-oriented" throughout the text.

* (spelling) I'd prefer seeing a hyphen in the term "object-oriented" throughout the text.

* (spelling) paragraph 3: "decade old" => "decade-old"

* (spelling) paragraph 3: "decade old" => "decade-old"

--[[User:AdamDingle|AdamDingle]]

--[[User:AdamDingle|AdamDingle]]

* Third paragraph makes claims about backwards compatibility, which I mostly agree with. However, I got started with platform development just after 4.0 was released and tried to follow examples from the NetBeans Definitive Guide. I remember vividly that I could not get anything to work because of the NoClassDefFound errors on TopManager, so I would recommend making those claims a little less strong in case others remember as well.

* Third paragraph makes claims about backwards compatibility, which I mostly agree with. However, I got started with platform development just after 4.0 was released and tried to follow examples from the NetBeans Definitive Guide. I remember vividly that I could not get anything to work because of the NoClassDefFound errors on TopManager, so I would recommend making those claims a little less strong in case others remember as well.

--[[User:TomWheeler|TomWheeler]]

--[[User:TomWheeler|TomWheeler]]

* Grammar: last paragraph, your tenses are mixed. I would suggest: "Since then, I've known the need for information relating to API design is real. The memory of that presentation has encouraged me whenever I've begun to lose motivation while writing this book. It has helped to remind me that the rules for proper API design that we've discovered need to be documented.

* Grammar: last paragraph, your tenses are mixed. I would suggest: "Since then, I've known the need for information relating to API design is real. The memory of that presentation has encouraged me whenever I've begun to lose motivation while writing this book. It has helped to remind me that the rules for proper API design that we've discovered need to be documented.

--[[User:RichUnger|RichUnger]]

--[[User:RichUnger|RichUnger]]