On 08.09.2006 17:20, Steven Edwards wrote:
On 9/8/06, Alexandre Julliard julliard@winehq.org wrote:
Since many people don't seem to understand this, from now on I'm going to reject all patches that add documentation, unless the submitter explicitly mentions that he didn't look at MSDN to write it. I'm sorry to penalize people who do the right thing, but I can't continue to waste time checking every single doc patch against MSDN.
"NOTE: When submitting documentation changes, you must clearly state that when creating your patch that you did not copy the function documentation from MSDN. When implementing a new function it is fine to look at the API documentation on MSDN however the api documentation must be written in your own words."
Hm, but wouldn't "didn't look at MSDN" also include "rewording"? To reword something, you need to look at the original, after all. So in the strictest interpretation, it looks to me that only "clean-room docs" (infer the documentation by looking at the source code) would be acceptable.
-f.r.