[Developers] Documentation urgently needs a wiki + Getting started with PHP
Dan Milbrath
dmilbrath at metaweb.com
Fri Jul 6 06:30:49 UTC 2007
Will,
thanks for the useful feedback. Comments below.
>> From: "Will Moffat" <will at hamstersoup.com>
>> Date: July 5, 2007 4:13:14 AM PDT
>> To: developers at freebase.com
>> Subject: [Developers] Documentation urgently needs a wiki + Getting
>> started with PHP
>>
>>
>> Some of the problems:
>> * There is no visible feedback mechanism for the documentation pages.
>> At the very least a wiki or discussion system needs to be added so
>> that people share their problems. Even if all they do is to add a note
>> "This doesn't work" then that will save lots of pain and bad feeling.
We're in the process of making the API into a series of Freebase topics, complete with discuss functionality.
You can see this here: http://www.freebase.com/view/helptopic?id=%239202a8c04000641f800000000544e14d
>> * Some of the tutorials no longer work. It's very disheartening to a
>> new developer when the tutorials are buggy. Hello world apps must just
>> work out of the box. Developers new to Freebase just don't have the
>> experience to fix simple bugs and will just give up.
We'll try get these fixed shortly.
>> * The help doesn't seem to be searchable. (It would be great if it was
>> exposed as static html without authentication and crawled by Google.)
We're working on addressing that in an upcoming release.
More information about the Developers
mailing list