This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
api_guessing_game [2017/09/30 19:45] shane [Read this even if you skipped to the bottom] |
api_guessing_game [2017/10/01 14:44] (current) shane [Read this even if you skipped to the bottom] |
||
---|---|---|---|
Line 9: | Line 9: | ||
===== Signs that one is stuck in the API Guessing Game ===== | ===== Signs that one is stuck in the API Guessing Game ===== | ||
- | * Having to write " | + | * Writing |
- | * Having no idea how to start implementing an operation using the library... | + | * Having no idea how to start implementing an operation |
* Having no which parts of the library are fundamental and unlikely to change, as opposed to those which are still under development... | * Having no which parts of the library are fundamental and unlikely to change, as opposed to those which are still under development... | ||
* Being fairly sure that a specific class (or group of functions and data structures) is the right one for a specific purpose, but having no idea of the order in which the various functions are supposed to be called... | * Being fairly sure that a specific class (or group of functions and data structures) is the right one for a specific purpose, but having no idea of the order in which the various functions are supposed to be called... | ||
Line 29: | Line 29: | ||
Choosing to use someone else's code library and API is (or //should be//) a // | Choosing to use someone else's code library and API is (or //should be//) a // | ||
* If I'm stuck using your code because there' | * If I'm stuck using your code because there' | ||
- | * If your library is the best thing around, but your commercial license fees are exorbitant (I'm looking at you, [[https:// | + | * If your library is the best thing around, but your commercial license fees are exorbitant (I'm looking at you, Intel, and pretty much every DSP library vendor on the planet), your documentation had better be first-class or I will look elsewhere. |
* If your library is free and/or open-source, | * If your library is free and/or open-source, | ||
- | * Whoever you are, don't give me attitude. You may be very clever, but you're not // | + | * Whoever you are, don't give me attitude. You may be very clever, but you're not //that// clever. |