Re: The State of the Docs Address 2007
Also i hope the blog tutorial will be extended to things which you will commonly encouter.. like for example add saving / and retrieving HABTM tags, and pagination and simple authorisation, logging allowing acces to add and edit posts. Also it would be nice if it showed how to deal with loading a different controller and use it's functions. Also the use of blocks, helpers behaviours should be in it. --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
On Jun 20, 6:37 am, Dérico Filho <[EMAIL PROTECTED]> wrote: > Hi John, > > Just one question. What is it the licence and the Cake Software > Foundation policy regarding this new documentation, is it already > defined? > > Uldérico Why has this question not been addressed yet? It's an extremely important question, IMHO, and deserves a salient response. --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
Well i hope we will be able to test read the docs and comment on it soon.. as there is very little documentation about 1.2 at the moment : ( I hope there will be more ajax related stuff in it too, as with the current docs there is not so much about it :( --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
I'm a new Cake 1.2 user who would be happy to contribute to the docs in any way a n00b can--finding errors, fixing them where possible, copyediting, prose-clarifying, or just generally raising hell. Please let me know who I should contact (or, they may feel free to contact me). Many thanks to all involved in Cake, Robert K S Paris --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
Hi John, Just one question. What is it the licence and the Cake Software Foundation policy regarding this new documentation, is it already defined? Uldérico On Jun 19, 6:21 pm, "John David Anderson (_psychic_)" <[EMAIL PROTECTED]> wrote: > Bakers one and all, > > I think the recent "Commented Version of CakePHP Manual" is a direct > result of me not sharing what's going on with the docs: where we've > been, and where we're headed. Hopefully I can clear this up a bit > right now. > > First, the wiki was a festering pit of misinformation and outdated > information. It caused much more grief than it eased, and I am > forever grateful it is long gone. The bakery is a perfect replacement > - its a way for users to contribute content that we can date, tie to > a specific version of cakephp, and most importantly monitor for > accuracy and quality. To me the bakery is a huge success. > > What we're working on now is a way to make the manual more community > oriented. This includes the ability for community members to: > > - Contribute content > - Correct content > - Translate > - Comment > > This system is already under way, and will also help us convert the > manual to PDF, CHM, and HTML (via the DocBook XML format). > > There are currently *no* official docs for v1.2, nor will there be > until we have a final release. Things are changing (for the good), > things are being added on, and it does me no good to chase a moving > target. That said, we're almost 100 pages into the 1.2 manual, which > is has been greatly updated in the area of helping people see the big > picture with CakePHP (MVC basics, class/file overviews, etc.). > > If you'd like to see the outline of the new manual, check out the > wiki tab on the cakedocs project at cakeforge. > > By the way, the cakedocs team only has about 5 or 6 active members. > I'd love to have any help if you're interested in making the docs > better. If you want to volunteer time, please, please, please come > and talk to someone on the team so we can get you channelled into > something we're working on. We always appreciate community help. We > always appreciate outside efforts - however - if you want to make the > most difference for the most people, contribute to an official project. > > Questions, suggestions? > > -- John --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
On Jun 20, 12:10 pm, keymaster <[EMAIL PROTECTED]> wrote: > It has been said on earlier "official" alpha releases that while the > API might still change and new features might still be added, what is > there is deemed to be pretty stable. > > So, perhaps it is not such a bad idea to release what is available on > the 1.2 Docs using the same understanding. Call it alpha, say it can/ > is changing. For that to work it would have to be pseudo complete. If you release something which is more holes than substance that's no use to anybody. But anyway, please people: don't distract John. Time spent by those working on docs answering the group (for things that are already planned and in motion) is not time well spent. Fresh ideas: cool; old repetitive debates: bad. :) cheers, AD --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
It has been said on earlier "official" alpha releases that while the API might still change and new features might still be added, what is there is deemed to be pretty stable. So, perhaps it is not such a bad idea to release what is available on the 1.2 Docs using the same understanding. Call it alpha, say it can/ is changing. But you will surely get input on mistakes in the docs and things you can do better. Then, when 1.2 really goes beta/stable, your docs will match. If you hold the docs close to your chest until the very last minute when 1.2 goes final, you will release alpha level docs for a "final" product. Perhaps it might be better to let the docs soak in the public as alpha, solicit the bugs/feedback, and keep the docs in synch with the status of the code. I agree it wouldn't have made sense to do this earlier, but now - how much is 1.2 really changing? Is it still really worth not releasing the docs? --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
Thanks for the update John. I look forward to seeing the 1.2 manual when it is released. I am pretty new to CakePHP and am developing my app on the 1.2.x.x code base. To date there has not been a single problem that I could not overcome by browsing this group, the api, or the Bakery. I encourage folks who are stuck on something to ask questions. We all benefit from the answers. The CakePHP community as a whole is a walking, talking, manual :) Cheers, Billy --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
On Jun 19, 2007, at 3:31 PM, Jonathan Langevin wrote: > Thanks for the info, it's greatly appreciated :-) > > I'd love to be able to help out, but I dunno that I have anything > to contribute. I'm 2 weeks into Cake (I've tested it before, but > never attempted development until now), and I'm about as lost as > most of the other newbies out there, if not more :-) Please search this group for the many times I've said how much caken00bs can contribute. We need new eyes, people. They are the best at identifying weak points in the content. -- John P.S. - And don't tell me you're too busy, because I'm busy too, and so is everyone else. :) --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
Re: The State of the Docs Address 2007
Thanks for the info, it's greatly appreciated :-) I'd love to be able to help out, but I dunno that I have anything to contribute. I'm 2 weeks into Cake (I've tested it before, but never attempted development until now), and I'm about as lost as most of the other newbies out there, if not more :-) if you have any tasks that a n00b can help with, let me know On 6/19/07, John David Anderson (_psychic_) <[EMAIL PROTECTED]> wrote: > > > Bakers one and all, > > I think the recent "Commented Version of CakePHP Manual" is a direct > result of me not sharing what's going on with the docs: where we've > been, and where we're headed. Hopefully I can clear this up a bit > right now. > > First, the wiki was a festering pit of misinformation and outdated > information. It caused much more grief than it eased, and I am > forever grateful it is long gone. The bakery is a perfect replacement > - its a way for users to contribute content that we can date, tie to > a specific version of cakephp, and most importantly monitor for > accuracy and quality. To me the bakery is a huge success. > > What we're working on now is a way to make the manual more community > oriented. This includes the ability for community members to: > > - Contribute content > - Correct content > - Translate > - Comment > > This system is already under way, and will also help us convert the > manual to PDF, CHM, and HTML (via the DocBook XML format). > > There are currently *no* official docs for v1.2, nor will there be > until we have a final release. Things are changing (for the good), > things are being added on, and it does me no good to chase a moving > target. That said, we're almost 100 pages into the 1.2 manual, which > is has been greatly updated in the area of helping people see the big > picture with CakePHP (MVC basics, class/file overviews, etc.). > > If you'd like to see the outline of the new manual, check out the > wiki tab on the cakedocs project at cakeforge. > > By the way, the cakedocs team only has about 5 or 6 active members. > I'd love to have any help if you're interested in making the docs > better. If you want to volunteer time, please, please, please come > and talk to someone on the team so we can get you channelled into > something we're working on. We always appreciate community help. We > always appreciate outside efforts - however - if you want to make the > most difference for the most people, contribute to an official project. > > Questions, suggestions? > > -- John > > > > --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Cake PHP" group. To post to this group, send email to cake-php@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/cake-php?hl=en -~--~~~~--~~--~--~---
