All logs
From APIDesign
Combined display of all available logs of APIDesign. You can narrow down the view by selecting a log type, the user name, or the affected page.
View (previous 100) (next 100) (20 | 50 | 100 | 250 | 500)
- 06:03, 14 June 2008 Apidesign (Talk | contribs) deleted "Beware of Using Other APIs" (Author request: content before blanking was: ''''Done: acc761a59107''' Page 147, para 2: Java collections use <tt>size</tt>, not <tt>getSize</tt>. Also the Javadoc refers to the Collections API as to "Collections Framework". Page 147, para -1: the 2.2 k)
- 06:03, 14 June 2008 Apidesign (Talk | contribs) deleted "Enforcing Consistency of APIs" (Author request: content before blanking was: ''''Done: f69d2163f4c8''' Page 154, code example: bad indentation of the class header. Having a final class whose all methods return null really is bulletproof, but it can also confuse the reader. Please cons)
- 06:03, 14 June 2008 Apidesign (Talk | contribs) deleted "Do Not Overuse the JavaBeans Listener Pattern" (Author request: content before blanking was: 'I would argue this is a good example of a case where your definition of cluelessness doesn't match the one of most Java developers out there. People are so used to implementing listener support, that even the )
- 06:03, 14 June 2008 Apidesign (Talk | contribs) deleted "Prevent Misuses of the API" (Author request: content before blanking was: ''''Done: 414c75f60371''' Page 161, para -2: "Javadoc" instead of "JavaDoc". Page 162, code example: <tt>public</tt> not used on interface methods -- inconsistent with other sections. Also, whether to make <t)
- 06:03, 14 June 2008 Apidesign (Talk | contribs) deleted "Delegation and Composition" (Author request: content before blanking was: 'Page 155, <tt>Arithmetica</tt> code example: it is prone to overflows, and <tt>sumRange</tt> can throw <tt>NegativeArraySizeException</tt>. OK, this is probably a nitpick and readers will understand that it's )
- 06:03, 14 June 2008 Apidesign (Talk | contribs) marked r902 of Talk:Cooperating with Other APIs patrolled (automatic)
- 06:02, 14 June 2008 Apidesign (Talk | contribs) marked r901 of Delegation and Composition patrolled (automatic)
- 06:02, 14 June 2008 Apidesign (Talk | contribs) marked r900 of Enforcing Consistency of APIs patrolled (automatic)
- 06:02, 14 June 2008 Apidesign (Talk | contribs) marked r899 of Beware of Using Other APIs patrolled (automatic)
- 06:02, 14 June 2008 Apidesign (Talk | contribs) marked r898 of Prevent Misuses of the API patrolled (automatic)
- 06:01, 14 June 2008 Apidesign (Talk | contribs) marked r897 of Do Not Overuse the JavaBeans Listener Pattern patrolled (automatic)
- 06:01, 14 June 2008 Apidesign (Talk | contribs) marked r896 of Cooperating with Other APIs patrolled (automatic)
- 06:01, 14 June 2008 Apidesign (Talk | contribs) marked r895 of Reviewers:PartII patrolled (automatic)
- 06:00, 14 June 2008 Apidesign (Talk | contribs) deleted "Good Tools make any API easier" (Author request: content before blanking was: ''''Done: 1f7473745841''' - more emphasis on testing This section doesn't deal with testing as much as with the idea that wizards lower the learning curve of the API. --AndreiBadea 14:01,)
- 06:00, 14 June 2008 Apidesign (Talk | contribs) deleted "The fade of specification" (Author request: content before blanking was: ''''Done: 03f60f4d2ef8''' Page 140, para -3: "Hotspot" should be "HotSpot". --AndreiBadea Some re-implementations occur even in OSS (integer-only OGG, for example). There are technical )
- 06:00, 14 June 2008 Apidesign (Talk | contribs) marked r894 of The fade of specification patrolled (automatic)
- 06:00, 14 June 2008 Apidesign (Talk | contribs) marked r893 of Good Tools make any API easier patrolled (automatic)
- 06:00, 14 June 2008 Apidesign (Talk | contribs) marked r892 of Talk:Keep Testability In Mind patrolled (automatic)
- 05:59, 14 June 2008 Apidesign (Talk | contribs) marked r891 of Keep Testability In Mind patrolled (automatic)
- 05:59, 14 June 2008 Apidesign (Talk | contribs) marked r890 of Reviewers:PartII patrolled (automatic)
- 05:59, 14 June 2008 Apidesign (Talk | contribs) marked r889 of Talk:Separate APIs for Client APIs and Support APIs patrolled (automatic)
- 05:58, 14 June 2008 Apidesign (Talk | contribs) deleted "Writer Evolution between Java 1.4 and 1.5" (Author request: content before blanking was: ''''Done: cc4e959ec9de''' Page 124, <tt>CountingWriter</tt> code example: <tt>@author</tt> tag probably not needed. Page 126, code example: <tt>convertChar</tt> is a very bad name for the function -- it does)
- 05:58, 14 June 2008 Apidesign (Talk | contribs) deleted "Split Your API Reasonably" (Author request: content before blanking was: ''''Done: 70c0c4836a28''' Page 134, para -2: "masterfs" will only make sense to NetBeans developers. Why not use "master filesystem" instead? --AndreiBadea 13:52, 8 April 2008 (UTC) Pag)
- 05:58, 14 June 2008 Apidesign (Talk | contribs) marked r888 of Split Your API Reasonably patrolled (automatic)
- 05:58, 14 June 2008 Apidesign (Talk | contribs) deleted "Expressing API/SPI in C and Java" (Author request: content before blanking was: ''''Done: 4b040ec30843''' Page 121: <tt>xmms_register_playback</tt> should take a <tt>(void)(*f)(char*)</tt> parameter (note the order of <tt>*</tt> and <tt>f</tt>). Moreover, the parentheses around <tt>void<)
- 05:58, 14 June 2008 Apidesign (Talk | contribs) marked r887 of Writer Evolution between Java 1.4 and 1.5 patrolled (automatic)
- 05:57, 14 June 2008 Apidesign (Talk | contribs) marked r886 of Expressing API/SPI in C and Java patrolled (automatic)
- 05:57, 14 June 2008 Apidesign (Talk | contribs) marked r885 of Separate APIs for Client APIs and Support APIs patrolled (automatic)
- 05:56, 14 June 2008 Apidesign (Talk | contribs) marked r884 of Reviewers:PartII patrolled (automatic)
- 05:56, 14 June 2008 Apidesign (Talk | contribs) deleted "Intercomponent Lookup and Communication" (Author request: content before blanking was: ''''Done: dd09dc43619c''' - I am currently rewriting this part to reflect your comments. As the topic is quite alive, I have also created a dedicated online page for this called Injection. Page 104, para -)
- 05:56, 14 June 2008 Apidesign (Talk | contribs) deleted "Lookup is Everywhere" (Author request: content before blanking was: ''''Done: d0b6efbc74d8''' Page 115: only seasoned NetBeans developers will know what <tt>ic</tt> in <tt>ic.add(new ModifiedImpl(this))</tt> stands for. I think you can just drop the example. Page 116: code e)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) deleted "The Need for Cyclic Dependencies" (Author request: content before blanking was: ''''Done: b058ea24096e''' Page 113, code example: <tt>encode</tt> should be <tt>encrypt</tt>. And probably it should return a <tt>byte[]</tt>. OK, you claim the example is a bit artificial, so consider this a )
- 05:55, 14 June 2008 Apidesign (Talk | contribs) deleted "Writing an Extension Point" (Author request: content before blanking was: ''''Done: bc774fd94cce''' <tt>TipOfTheDay</tt> example: <tt>sayHello</tt> doesn't seem a good name for the method. How about <tt>getTip</tt>? Page 109, para -2,-4: extra "s" in <tt>TipsOfTheDay</tt>. Page 10)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) marked r883 of Talk:Use Modular Architecture patrolled (automatic)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) marked r882 of Lookup is Everywhere patrolled (automatic)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) marked r881 of The Need for Cyclic Dependencies patrolled (automatic)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) marked r880 of Writing an Extension Point patrolled (automatic)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) marked r879 of Intercomponent Lookup and Communication patrolled (automatic)
- 05:55, 14 June 2008 Apidesign (Talk | contribs) deleted "Types Of Modular Design" (Author request: content before blanking was: ''''Done: 134c6f9cad88''' Page 103, para 1: "using some sort of Hashtable" -- <tt>DriverManager</tt> uses <tt>Vector</tt>'s (but sure, you can view it as a dictionary with <tt>O(N)</tt> complexity). The regist)
- 05:54, 14 June 2008 Apidesign (Talk | contribs) marked r878 of Types Of Modular Design patrolled (automatic)
- 05:54, 14 June 2008 Apidesign (Talk | contribs) marked r877 of Use Modular Architecture patrolled (automatic)
- 05:53, 14 June 2008 Apidesign (Talk | contribs) APIDesignPatterns:ResponseReply moved to APIDesignPatterns:RequestResponse
- 05:53, 14 June 2008 Apidesign (Talk | contribs) marked r874 of Code Against Interfaces, Not Implementations patrolled (automatic)
- 05:51, 14 June 2008 Apidesign (Talk | contribs) marked r873 of Reviewers:PartII patrolled (automatic)
- 05:51, 14 June 2008 Apidesign (Talk | contribs) deleted "Getting Ready for Growing Parameters" (Author request: content before blanking was: ''''Done: f1d73f9490a0''' The <tt>Request/Response</tt> example has a few superfluous usages of <tt>this</tt>. Or perhaps you prefer to prefix all field references with <tt>this</tt> -- that's fine, but it sho)
- 05:51, 14 June 2008 Apidesign (Talk | contribs) deleted "Are Abstract Classes Useful?" (Author request: content before blanking was: ''''Done: a578de6e7ceb''' agreed but not in such strong way Static factory methods can be put into a separate noninstantiable class: public interface Tweeter { void tweet(); } public class Tweeters { )
- 05:51, 14 June 2008 Apidesign (Talk | contribs) deleted "A Method Addition Lover's Heaven" (Author request: content before blanking was: ''''Done: 24bf47daa023''' The "public final class InstanceProvider" does not make sense as written. The whole point of InstanceProvider is that it is something that has to be implemented, as well as called. If)
- 05:51, 14 June 2008 Apidesign (Talk | contribs) deleted "Comparing Java Interfaces and Classes" (Author request: content before blanking was: ''''Done: cd866eaf3b80''' - I've explained something but not all the details. Still you need to know at least a bit of knowledge how the VM stores the objects, or you need to trust me that I know. Your compari)
- 05:51, 14 June 2008 Apidesign (Talk | contribs) deleted "Adding a Method or a Field" (Author request: content before blanking was: ''''Done: e368fc1dbe72''' The sentence "Imagine that NetBeans had used a different signature for the aforementioned method..." is a bit hard to read, mostly because of "different". Instead, consider something )
- 05:51, 14 June 2008 Apidesign (Talk | contribs) marked r872 of Talk:Code Against Interfaces, Not Implementations patrolled (automatic)
- 05:50, 14 June 2008 Apidesign (Talk | contribs) marked r871 of Getting Ready for Growing Parameters patrolled (automatic)
- 05:50, 14 June 2008 Apidesign (Talk | contribs) marked r870 of Are Abstract Classes Useful? patrolled (automatic)
- 05:50, 14 June 2008 Apidesign (Talk | contribs) marked r869 of A Method Addition Lover's Heaven patrolled (automatic)
- 05:50, 14 June 2008 Apidesign (Talk | contribs) marked r868 of Comparing Java Interfaces and Classes patrolled (automatic)
- 05:49, 14 June 2008 Apidesign (Talk | contribs) marked r867 of Adding a Method or a Field patrolled (automatic)
- 05:49, 14 June 2008 Apidesign (Talk | contribs) marked r866 of Code Against Interfaces, Not Implementations patrolled (automatic)
- 05:48, 14 June 2008 Apidesign (Talk | contribs) marked r865 of Do Not Expose More Than You Want patrolled (automatic)
- 05:47, 14 June 2008 Apidesign (Talk | contribs) marked r864 of Reviewers:PartII patrolled (automatic)
- 05:46, 14 June 2008 Apidesign (Talk | contribs) marked r863 of Talk:Do Not Expose More Than You Want patrolled (automatic)
- 05:46, 14 June 2008 Apidesign (Talk | contribs) deleted "Do Not Expose Deep Hierarchies" (Author request: content before blanking was: ' # Page 85: I really liked the examples about design flaws in Swing. I like that you're teaching people how to design APIs by pointing out both the right way and the wrong way of doing it, particularly when t)
- 05:46, 14 June 2008 Apidesign (Talk | contribs) marked r862 of Do Not Expose Deep Hierarchies patrolled (automatic)
- 05:46, 14 June 2008 Apidesign (Talk | contribs) deleted "Give the Creator of an Object More Rights" (Author request: content before blanking was: ''''Fixed a bit as 8577a4d13185''' First paragraph: SmallTalk should be Smalltalk. The <tt>Executor</tt> and <tt>Configuration</tt> example: either <tt>Configuration</tt> is a public API class (wrong since i)
- 05:46, 14 June 2008 Apidesign (Talk | contribs) marked r861 of Give the Creator of an Object More Rights patrolled (automatic)
- 05:45, 14 June 2008 Apidesign (Talk | contribs) deleted "Allow Access Only From Friend Code" (Author request: content before blanking was: ''''Fixed: fd5ed0a24e62''' Slightly bad coding style in the accessor example: public final class Item { ... public void setValue(int x) { It is customary to name setter pararameters after the name)
- 05:45, 14 June 2008 Apidesign (Talk | contribs) marked r860 of Allow Access Only From Friend Code patrolled (automatic)
- 05:45, 14 June 2008 Apidesign (Talk | contribs) deleted "Do Not Put Setters Where They Do Not Belong" (Author request: content before blanking was: ''''Fixed: 884544ab39ec''' This section communicates its point well, but given the popularity of Spring, a mention of IoC is probably warranted. Just referencing the later section on IoC is fine. --User:Rich)
- 05:45, 14 June 2008 Apidesign (Talk | contribs) marked r859 of Do Not Put Setters Where They Do Not Belong patrolled (automatic)
- 05:45, 14 June 2008 Apidesign (Talk | contribs) deleted "Make Everything Final" (Author request: content before blanking was: ''''Fixed: f8cac2a753b7''' The examples in this section are of little value -- most, if not all, readers know how to override a method. Instead, more useful would be an example of what might go wrong when a cl)
- 05:44, 14 June 2008 Apidesign (Talk | contribs) marked r858 of Make Everything Final patrolled (automatic)
- 05:44, 14 June 2008 Apidesign (Talk | contribs) deleted "A Factory Is Better Than a Constructor" (Author request: content before blanking was: ''''Fixed: 68efa8b9841a''' The sentence "you can synchronize better when invoking a factory method" needs more detail. Other reasons for factory methods are well described in Effective Java, but not this one. )
- 05:44, 14 June 2008 Apidesign (Talk | contribs) marked r857 of A Factory Is Better Than a Constructor patrolled (automatic)
- 05:44, 14 June 2008 Apidesign (Talk | contribs) deleted "A Method Is Better Than A Field" (Author request: content before blanking was: ''''Fixed: f4219513dece''' Regarding "public static final constants": # These are not constants at all if the type is neither primitive nor String. Definitely avoid nonconstant fields, even if static and final)
- 05:43, 14 June 2008 Apidesign (Talk | contribs) marked r856 of A Method Is Better Than A Field patrolled (automatic)
- 05:43, 14 June 2008 Apidesign (Talk | contribs) marked r855 of Talk:Do Not Expose More Than You Want patrolled (automatic)
- 05:43, 14 June 2008 Apidesign (Talk | contribs) marked r854 of Reviewers:PartII patrolled (automatic)
- 05:41, 14 June 2008 Apidesign (Talk | contribs) marked r853 of Talk:Yet Another Design Book? patrolled (automatic)
- 05:41, 14 June 2008 Apidesign (Talk | contribs) deleted "Practical Design" (Author request: content before blanking was: 'Most of the advice you present throughout this entire part is specific to Java. It's true that a good number of your points could be applied to other languages, but there's no way that someone who doesn't kno)
- 05:41, 14 June 2008 Apidesign (Talk | contribs) marked r852 of Practical Design patrolled (automatic)
- 05:38, 14 June 2008 Apidesign (Talk | contribs) marked r851 of Reviewers:PartI patrolled (automatic)
- 05:37, 14 June 2008 Apidesign (Talk | contribs) deleted "Functional Compatibility" (Author request: content before blanking was: '* The captions in Figure 5.1 and 5.2, "How we think our applications look like", is not grammatically correct. Use "How we think our applications look", "How it really looks". * Figure 5.3: "in Next Version" )
- 05:37, 14 June 2008 Apidesign (Talk | contribs) marked r850 of Talk:Ever Changing Targets patrolled (automatic)
- 05:37, 14 June 2008 Apidesign (Talk | contribs) deleted "Incremental Improvements" (Author request: content before blanking was: '* p 67, para 2: "How Many People Have to Die?": ha - I like this expression and may start using it myself! * p 59, para 5: "optimists" => "optimist's" * p 59, para 5: "before big bang and after big band" => ")
- 05:37, 14 June 2008 Apidesign (Talk | contribs) marked r849 of Incremental Improvements patrolled (automatic)
- 05:37, 14 June 2008 Apidesign (Talk | contribs) deleted "Life-cycle of an API" (Author request: content before blanking was: 'AndreiBadea: Using Linux kernel as an example of compatible development is a bit adventurous, as kernel developers are proud of having no compatibility. JaroslavTulach true, for their modules and APIs )
- 05:37, 14 June 2008 Apidesign (Talk | contribs) marked r848 of Life-cycle of an API patrolled (automatic)
- 05:36, 14 June 2008 Apidesign (Talk | contribs) deleted "API Reviews" (Author request: content before blanking was: '* p 54, para 3: "commitee. That it needs" => "committee, that it needs" (fix spelling, sentence fragment) * p 54, para 5: "users. Also, that" => "users, and also that" (fix sentence fragment) * p 54, para -4: )
- 05:36, 14 June 2008 Apidesign (Talk | contribs) marked r847 of API Reviews patrolled (automatic)
- 05:36, 14 June 2008 Apidesign (Talk | contribs) deleted "The Importance of Being Usecase Oriented" (Author request: content before blanking was: '* section title: "Usecase Oriented" => "Use Case Oriented" or "Use Case-Oriented" * p 51, para -2: "usecase oriented" => "use case oriented" or "use case-oriented" * p 51, para -2: "Anyway," => "In any case," )
- 05:36, 14 June 2008 Apidesign (Talk | contribs) marked r846 of The Importance of Being Usecase Oriented patrolled (automatic)
- 05:35, 14 June 2008 Apidesign (Talk | contribs) marked r845 of Functional Compatibility patrolled (automatic)
- 05:35, 14 June 2008 Apidesign (Talk | contribs) deleted "Backward Compatibility" (Author request: content before blanking was: '* p 41, para -2: "the same name and also arguments" => "the same name and arguments" * p 41, para -2: "but different return type" => "but a different return type" * p 41, para -2: "the Java languages" => "the )
- 05:35, 14 June 2008 Apidesign (Talk | contribs) marked r844 of Backward Compatibility patrolled (automatic)
- 05:35, 14 June 2008 Apidesign (Talk | contribs) deleted "Source Compatibility" (Author request: content was: '* "becamed" -> "became" --Dmkoelle 21:57, 4 April 2008 (UTC)' (and the only contributor was 'Dmkoelle'))
- 05:34, 14 June 2008 Apidesign (Talk | contribs) deleted "The first version is never perfect" (Author request: content before blanking was: '* p 40, para 3: "the first version is never perfect": why is this quoted? Who are you quoting? If you mean to emphasize this, italics are a better choice. See e.g. http://en.wikipedia.org/wiki/Quotation_mark)
- 05:34, 14 June 2008 Apidesign (Talk | contribs) marked r843 of The first version is never perfect patrolled (automatic)
- 05:34, 14 June 2008 Apidesign (Talk | contribs) marked r842 of Ever Changing Targets patrolled (automatic)
- 05:33, 14 June 2008 Apidesign (Talk | contribs) marked r841 of Reviewers:PartI patrolled (automatic)
- 05:32, 14 June 2008 Apidesign (Talk | contribs) marked r840 of Talk:How to Check the Quality of an API patrolled (automatic)
- 05:32, 14 June 2008 Apidesign (Talk | contribs) deleted "Preservation of Investment" (Author request: content before blanking was: '* "The more developers use, for example, the" -> "For example, the more programmers who use the" --Dmkoelle 21:56, 4 April 2008 (UTC)')
- 05:32, 14 June 2008 Apidesign (Talk | contribs) marked r839 of Preservation of Investment patrolled (automatic)