[Developers] Where is the canonical version of the Acre documentation?

[Stefano Mazzocchi]

Tom Morris wrote:
> OK, this is driving me nuts. There are a bunch of different places to
> look for Acre documentation and each one says something slightly
> different or has a piece of the puzzle that's not in one of the
> others.  One place has tutorials but they don't use any recent
> facilities, another has a tutorials section, but it's empty.  Some
> things I can't find anywhere.
> 
> What is most up-to-date?  What is most complete?  (Hopefully these two
> questions don't have different answers)
> 
> For bonus points:
> 
> - Where can I find a conceptual overview, especially what gets
> executed where (server vs client) in which order?
> - What does the "def" attribute in the following do? <acre:block
> def="renderTask(taskData, isIPhone)">
> - Where can I find an example of simple paged output using Acre?

Tom,

we are fully aware of the state of the documentation (not only Acre's 
but the entire developer's documentation for Freebase as a platform) and 
I have shared a lot of your frustration in the past, but we are working 
hard to improve the situation for the Acre 1.0 release which is 
scheduled for the HackDay.

In the meanwhile, you can follow our progress at

  http://freebaseapps.com/docs

but yes, there are holes and there are mistakes, so pardon our mess 
while we fix it.

As for the bonus points:

1) there is no such conceptual overview yet, you'll find it after the 
release at

   http://freebaseapps.com/docs/acre_intro

2) def defines the MJT block as a function so that you can call it 
(think of it as a macro)

  http://freebaseapps.com/docs/acre_templates/attributes

see the 'def' section.

3) I honestly don't know.

Hope this helps.

-- 
Stefano Mazzocchi                              Application Catalyst
Metaweb Technologies, Inc.                      stefano at metaweb.com
-------------------------------------------------------------------