Ary Borenszweig, el 2 de agosto a las 00:07 me escribiste: > Leandro Lucarella escribió: > >Ary Borenszweig, el 1 de agosto a las 16:29 me escribiste: > >>http://www.prowiki.org/wiki4d/wiki.cgi?LanguageDevel/DIPs/DIP6 > >Please, try to post at least the abstract of the DIP with the link, so > >people can easily know what is it about =) > >And when writing a DIP, try to make the abstract a little more > >descriptive. From an abstract you should be able to tell what the DIP is > >about (in this case explain what an annotation is at least). A oneliner is > >not good enough, that's just a title, not an abstract. If it's too hard > >to explain, try to provide a link to somewhere else where the terms are > >described. > >The rationale can be a little more descriptive too. What are the > >advantages of removing keywords for example? Use NG posts links if you > >have some problems documented there, for example. > >Try not to explain your opinion in DIPs. They are not NG posts, they > >should provide facts and be as objective as possible. Even when that's > >pretty hard, saying "I prefer Java's one because ..." is excessively > >subjective. Avoid doing that. You can express the same by saying something > >like "Java syntax has the advantage of ..." for example. > >A section called "Other thoughts" is not very serious either. If you are > >not yet convinced about something in the DIP, post it in the announcement > >post in the NG so it can be discussed and added later to the DIP when the > >idea is in better shape. > >Please, don't take this personally, I just want DIPs to be high quality, > >otherwise they will never be taken seriously. =) > >I've added this information in a Recommendations subsection to the DIP1, > >see: > >http://www.prowiki.org/wiki4d/wiki.cgi?LanguageDevel/DIPs/DIP1#Recommendations > >I'll address the DIP itself in another post ;) > > Hola Leandro, > > I've updated the DIP page with your recommendations. I agree with all of > them.
Thanks! -- Leandro Lucarella (luca) | Blog colectivo: http://www.mazziblog.com.ar/blog/ ---------------------------------------------------------------------------- GPG Key: 5F5A8D05 (F8CD F9A7 BF00 5431 4145 104C 949E BFB6 5F5A 8D05) ---------------------------------------------------------------------------- "Somos testigos de Jaimito, venimos a traer la salvación, el mundo va a desaparecer, somos testigos de Jaimito!". Nos enyoguizamos... Así que "somos testigos"? Te dejo el culo hecho un vino, y la conch'itumá, y la conch'itumá! -- Sidharta Kiwi
