> > You'll notice one of the new things in my proposal > was the idea of a string review. There are a lot > of crappy strings in our interfaces, often because > many of our programmers just don't have very good > English skills. > > And that's fine. Hey, my German pretty much sucks, > although I can get by with it. I can't expect the > world to have perfect English. So we'll do some > string reviews instead, where we can fix problems. > > But now you want all these programmers to assemble > their documentation piecemeal as they add features? > > Even if they all had perfect English (which they > don't), and even if they were all really good at > explaining things (which they aren't), this would > still produce bad documentation. Why? Because it > would only ever produce "What's this?" documents, > and never "How do I?" documents. > > I find myself shooting down this idea every single > release cycle. > > -- > Shaun > > Agree, it's really a problem, but look at usability guys, they all just do a review, interface is created by developers. Developers are certainly not professional UI designers but HIG shows them the correct direction. It's much easier to review something and correct mistakes then to write it from scratch. Gustavo's point about rising entrance barrier is also a good objection, but let me disagree that code is more important than docs. Moreover I think we should encourage newbies to write some docs, this way they will understand application and feature use cases, they will clear the vision of application behavior. Code is a minor thing we know, people make project better ;) But documentation is a minor thing, correct design decisions are much more important, documentation was the first item in the list, but I push roadmap policy and proposal policy more. Do we need cross-platform GNOME or not, do we provide complete development platform with stuff for collaboration, advanced messaging and networking or just an advanced UI library.. Heh, my German is even more worse, but I hope you'll get an idea.
Attachment:
signature.asc
Description: =?koi8-r?Q?=FC=D4=C1?= =?koi8-r?Q?_=DE=C1=D3=D4=D8?= =?koi8-r?Q?_=D3=CF=CF=C2=DD=C5=CE=C9=D1?= =?koi8-r?Q?_=D0=CF=C4=D0=C9=D3=C1=CE=C1?= =?koi8-r?Q?_=C3=C9=C6=D2=CF=D7=CF=CA?= =?koi8-r?Q?_=D0=CF=C4=D0=C9=D3=D8=C0?=