I would like to offer some help with the official docs. I'm not sure
how much time i can put in because, like everyone else, i've got a
crap-load on my plate already. But the docs do need some serious help.
The presentation, for one, makes it difficult to find things. That,
and the underlying gene
On Feb 8, 2008 2:10 PM, Baz <[EMAIL PROTECTED]> wrote:
> Isn't that just like the API, generated from code?
>
> And it seems to have stopped after 11/7/07
>
>
I think the plan was that it was going to support the notion of
comments like the php.net manual. But like you said it died, which
ha
[EMAIL PROTECTED] wrote:
> I second this. it's a great way to provide the general method and
> usage while also providing multiple, more specific examples that often
> are more relevant in the real world.
ONLY if they are moderated... too many people use the comments as a
place to request fr
Isn't that just like the API, generated from code?
And it seems to have stopped after 11/7/07
On Feb 8, 2008 2:54 PM, Samuel DeVore <[EMAIL PROTECTED]> wrote:
>
> > > I quite like the system in php.net - you've got the "official" docs
> > > pages, then a list of user-submitted relevant comme
> > I quite like the system in php.net - you've got the "official" docs
> > pages, then a list of user-submitted relevant comments underneath. I
> > often find what I'm looking for in the user comments. If these could
> > be moderated and other users could vote on them, it might make for a
> > fin
I second this. it's a great way to provide the general method and
usage while also providing multiple, more specific examples that often
are more relevant in the real world.
brian
Quoting grigri <[EMAIL PROTECTED]>:
>
> I quite like the system in php.net - you've got the "official" docs
> p
I quite like the system in php.net - you've got the "official" docs
pages, then a list of user-submitted relevant comments underneath. I
often find what I'm looking for in the user comments. If these could
be moderated and other users could vote on them, it might make for a
fine system to add to t
Why do we keep comparing to Zend? They got an entire team on doc. alone.
The think that our only problem here lies with 1.2. IMO, the current
1.1manual is fine for me (maybe have one complete doc, so you don't
have to
keep clicking through chapters).
The only thing we need right now is to get the
Hmmm yes all these blogs scattered everywhere really doesn't help
anybody... I hope one day cake will have a manual to the standards of
ZendFW.. http://framework.zend.com/manual/en/
It's easy to read and has lots of example code... for every part of
the framework.
--~--~-~--~~
On Feb 6, 6:03 pm, Baz <[EMAIL PROTECTED]> wrote:
> Personally, this is the problem I have with the lack of documentation:
>
> CakePHP was somewhat intimidating for me to get started with. With that
> said, I have done a few simple apps, an make-shift CMS that serves my
> purpose, and just genera
Thanks John for the reply. I really look forward to the new wiki-like
application.
- Rajesh
--~--~-~--~~~---~--~~
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
Rajesh,
The new application is very wiki-like. It allows easy contributions
(hopefully). It's different in that it has more structure (data is in
tree form) and there's an approval/revision process built in.
We hope it'll make things easier - hopefully we can have something to
show really
I ever think that you understood what i wrote. i just tried to explain
what would ease the pressure on you guys. If there was a discussion
previously on wiki, you could have just said "NO for a wiki" or "Its
on the way" but not they way you had said.
I just started cakePHP for about 4 months now
Ok ok ok, enough of all this talk
Pointing fingers is going to help.
I gather that people are busy, due to CakeFest etc. But when that's done,
I'm expecting someone to send me a link or something telling me where to go
to sign up for stuff.
Because I've heard tons of complaints about nobody
On Feb 7, 2008 1:03 PM, Rajesh <[EMAIL PROTECTED]> wrote:
>
> Just a suggestion, why not open up a WIKI where everyone can
> contribute and have a set of people as Moderators, that way sending
> emails back and forth for documentation would reduce and also that
> would ease the load on the people
I like that one.
On Feb 7, 2008 4:03 PM, Rajesh <[EMAIL PROTECTED]> wrote:
>
> Just a suggestion, why not open up a WIKI where everyone can
> contribute and have a set of people as Moderators, that way sending
> emails back and forth for documentation would reduce and also that
> would ease the l
Just a suggestion, why not open up a WIKI where everyone can
contribute and have a set of people as Moderators, that way sending
emails back and forth for documentation would reduce and also that
would ease the load on the people writing the current documentation.
-Rajesh
--~--~-~--~~
On Feb 7, 2008, at 6:17 AM, MonkeyGirl wrote:
>
> find a better way of doing something and I'll update my guide to do it
> that way instead."
>
> If I was writing official documentation, I'd feel like I was saying
> "this is how it's *supposed* to be done, how it *should* be done." I
> don't f
> By the way, I am Japanese. I think Japanese developers want to read
> documents in Japanese. So I want to translate your guide into Japanese.
> Can I do that?
The way I understand the hacker spirit, everybody's free to share and
build upon everyone else's work, which is what makes free software
On Feb 6, 5:03 pm, Baz <[EMAIL PROTECTED]> wrote:
> I'm never sure whether I'm doing things the "right" way. To be
> honest, all this MVC stuff was brand new to me by the time I started. This
> is why I've been hesitant to submit articles to the bakery, for example.
> Since a lot of my stuff, can
> Settle down - I think you've completely over-reacted. Nate's comment
> wasn't a flame, but yours was.
While Nate's opinion might be correct here (up to a point), it is
obvious that his people skills are not his forte.. This is not a
flame, it is just an opinion.
No hard feelings towards Nate,
Hi verybody!
I'm really newbie with Cake (since 4 months) and I'm French...
Of course, doc is a negative point for Cake, compared with Symfony or
Zend (and notably for international users they don't read English
easily).
It's harder to find, it's not updated, it's not simple.
But I'm agree with
Hello Zoe,
Thank you for your great work.
I am using cakePHP reading the source code. So, Now I can use cakePHP as
I want in many cases. However we need the guide for beginners, and I
think your guide will be such guide.
By the way, I am Japanese. I think Japanese developers want to read
docu
I completely agree with the comment about the API. I realize it is a
very technical document with a specific purpose, but a few lines of
example code here and there would broaden its reach to many more
users. I also agree with the sentiment about wanting to contribute but
being unsure of one's qua
On Feb 6, 2008, at 10:03 AM, Baz wrote:
> I can't help but feel that I'm not the only one who feels that way.
> What would "qualify" one to be able to contribute to the Official
> Cake documentation or the Bakery?
There is no qualification.
New people have the distinct advantage of being a
Personally, this is the problem I have with the lack of documentation:
CakePHP was somewhat intimidating for me to get started with. With that
said, I have done a few simple apps, an make-shift CMS that serves my
purpose, and just general fudging around with stuff and trying to get things
working.
On Feb 6, 2008 9:55 PM, phpjoy <[EMAIL PROTECTED]> wrote:
> I think that only an idiot would be happy to contribute to anything
> after such a stupid comment.
>
> I like CakePHP as a product (otherwise I wouldn't be here), but nate,
> you should work on your human skills.
Huh!
Where did that com
On Feb 6, 2008, at 9:25 AM, phpjoy wrote:
>
> That attitude is the exact difference between ExtJS which is more
> community-driven and Zend, which is cold and company-driven.
> ExtJS succeeds because the community-force behind it drives it
> forward, because people make tons of plugins. Because
That attitude is the exact difference between ExtJS which is more
community-driven and Zend, which is cold and company-driven.
ExtJS succeeds because the community-force behind it drives it
forward, because people make tons of plugins. Because they don't need
a "bakery", they have a simple forum w
theres a book coming for Cake too - by David Golding:
http://www.amazon.com/Beginning-CakePHP-Professional-David-Golding/dp/1430209771/
On Feb 5, 10:11 am, accom06 <[EMAIL PROTECTED]> wrote:
> This is great!
>
> Thanks.
>
> -- Aaron
>
> On 5 Feb, 08:58, "Julio Protzek" <[EMAIL PROTECTED]> wrot
This is great!
Thanks.
-- Aaron
On 5 Feb, 08:58, "Julio Protzek" <[EMAIL PROTECTED]> wrote:
> Hey, awsome work Zoe :)
>
> The official docs is really missing something like this. As Mark said, a
> rails book like tutorial is a great idea too.
> The lack of good, consistent and updated documenta
Hey, awsome work Zoe :)
The official docs is really missing something like this. As Mark said, a
rails book like tutorial is a great idea too.
The lack of good, consistent and updated documentation is the worst problem
for new users.
I agree with brian about the 'hidden' 1.2 docs.
In the end eve
Great work John!!
Really forward to reading this.
On Feb 4, 8:41 pm, "John David Anderson (_psychic_)"
<[EMAIL PROTECTED]> wrote:
> On Feb 4, 2008, at 6:23 PM, Keith wrote:
>
>
>
>
>
> > On Feb 4, 11:48 am, nate <[EMAIL PROTECTED]> wrote:
> >> John gets little to no help from outside contributor
This is great. Thanks!
On Feb 4, 8:41 pm, "John David Anderson (_psychic_)"
<[EMAIL PROTECTED]> wrote:
> On Feb 4, 2008, at 6:23 PM, Keith wrote:
>
>
>
>
>
> > On Feb 4, 11:48 am, nate <[EMAIL PROTECTED]> wrote:
> >> John gets little to no help from outside contributors, and the only
> >> way th
On Feb 4, 2008, at 6:23 PM, Keith wrote:
>
> On Feb 4, 11:48 am, nate <[EMAIL PROTECTED]> wrote:
>> John gets little to no help from outside contributors, and the only
>> way the
>> community has seen fit to contribute is with scattered, one-off
>> tutorials at various levels of currency, comp
On Feb 4, 11:48 am, nate <[EMAIL PROTECTED]> wrote:
> John gets little to no help from outside contributors, and the only way the
> community has seen fit to contribute is with scattered, one-off
> tutorials at various levels of currency, completeness and accuracy.
I agree with Nate here. I put
On Feb 4, 2008, at 10:48 AM, [EMAIL PROTECTED] wrote:
>
> I think it's a good start Zoe.
>
> I disagree with Nate on one point, I think the more examples and
> tutorials on Cake the better, regardless of where they exist. CakePHP
> desperately needs better documentation and once it has it, it's
I think it's a good start Zoe.
I disagree with Nate on one point, I think the more examples and
tutorials on Cake the better, regardless of where they exist. CakePHP
desperately needs better documentation and once it has it, it's
adoption rate might really skyrocket. Unfortunately this hasn
The only comment or criticism I have is that it's a shame that such
efforts aren't put towards the official documentation. John gets
little to no help from outside contributors, and the only way the
community has seen fit to contribute is with scattered, one-off
tutorials at various levels of cur
On Feb 4, 2008 11:13 AM, hellfish <[EMAIL PROTECTED]> wrote:
>
> Just a suggestion, it would be nice if someone wrote in that manual
> ways to configure different databases. I'm having a lot of trouble
> using SQL Server 2005 and it's been hard to find any documentation.
>
> cheers.
When you say
Just a suggestion, it would be nice if someone wrote in that manual
ways to configure different databases. I'm having a lot of trouble
using SQL Server 2005 and it's been hard to find any documentation.
cheers.
On 4 Feb, 13:46, Keith <[EMAIL PROTECTED]> wrote:
> Zoe,
>
> Looks promising! This i
Zoe,
Looks promising! This is an excellent idea. I've been trying to
document some of this stuff over at my blog as well. I have 2
tutorials posted for 1.2 there that you're more than welcome to use to
kick-start your work if you would like.
http://www.keithmedlin.com/
Regards,
Keith
On Fe
Just wanted to say: Great initiative!
We need this kind of documentation that the manual and API does not
(and probably should not) provide. I see three main kinds of
documentation.
The API = technical info on specific classes, methods, variables and
things.
The Manual = Descriptive info about th
Hi Zoe,
It would be cool if there is a way to subscribe to this guide, so you
automatically get notified if there is an update.
Anyway, good luck with this project!
--
Daniel Hofstetter
http://cakebaker.42dh.com
--~--~-~--~~~---~--~~
You received this message bec
Hi Zoe,
I think there is a definite need for this type clear introduction for
CakePHP. Documentation is key to the success of any open-source
project to help lower the barrier of entry. Please keep up the good
work, as even if there is some duplication of effort in the community,
we can never hav
45 matches
Mail list logo