[FLOW3-general] Current state of documentation and the 1.0 beta release

[Robert Lemke]

Hi folks,

I'd like to give you a little update on the current state of affairs. As some of you have realized recently, the documentation – including the Getting Started Tutorial – is not really matching the code we currently have in FLOW3 master. That is confusing, especially for you being new to FLOW3, and I apologize.

As you might have read, we got our hands really dirty in January this year and started a big refactoring which integrates Doctrine 2 and provides an improved proxy rendering mechanism. These are big last-minute changes before the first beta version and while most of the features now work, there are still some clean up and bug fixes we need to take care of. We are fully focussing on making the new features stable now and will let you know once we succeeded.

If you're curious and would like to help us testing the new code, you're very welcome to follow the changes in Gerrit (http://review.typo3.org) and give comments on them (click "review" and add comments). As a beginner, trying out the tutorial, you need to improvise a bit and try to fix broken lines yourself (make sure to share your insights in this list if you do). Or you just wait a few days / weeks (can't say exactly) until we updated the documentation.

In any case, if you're wondering how the persistence part of FLOW3 works (where does FLOW3 store my objects? what database fields are created? will I be able to store hundreds of thousands of records?), don't worry too much about it right now. With the Doctrine 2 support incorporated into the next FLOW3 release, many things at the low level and a few annotations at the client code level will change. It will be very easy to migrate your existing code, but on the database side it's a whole new framework taking care of persistence.

If you have any further questions, keep them coming! I hope that we (the core team members) will be able to respond more quickly than in the past. But I hope you understand that we're currently very busy with getting the API and documentation clean so we explain it to you afterwards ;-)

Cheers,
Robert

-- 
Robert Lemke – Fluent Code Artisan
http://robertlemke.de/blog

Lead Developer TYPO3 Phoenix and FLOW3
Co-Founder TYPO3 Association

Get involved: typo3.org – flow3.org