PHP Developers Network

A community of PHP developers offering assistance, advice, discussion, and friendship.
 
Loading
It is currently Sun Dec 21, 2014 1:41 pm

All times are UTC - 5 hours




Post new topic Reply to topic  [ 268 posts ]  Go to page Previous  1 ... 13, 14, 15, 16, 17, 18  Next
Author Message
 Post subject:
PostPosted: Tue Jul 11, 2006 3:38 am 
Offline
Forum Contributor

Joined: Wed Apr 26, 2006 4:19 am
Posts: 365
Location: Italy
Any thoughts on writing style? I've started putting down a few bits and pieces (so far only on database type stuff), and I was wondering how the group intends to write. So far, for me, it's been coming out in quite a narrative style, in the first person plural ("Let's look at our tables - we've got...", "Why should we design in this way?..."). Before doing too much more, I thought it'd be a better idea to check how we want the book to read - is it to be a "dry" technical manual type of book, or is it going to be a more "human", narrative type of book? At least if we can decide this it will make the editors' job easier if we all start in a vaguely similar style.


Top
 Profile  
 
 Post subject:
PostPosted: Tue Jul 11, 2006 4:48 am 
Offline
DevNet Resident
User avatar

Joined: Fri Apr 07, 2006 5:13 am
Posts: 1640
Location: Israel
GM wrote:
Any thoughts on writing style? I've started putting down a few bits and pieces (so far only on database type stuff), and I was wondering how the group intends to write. So far, for me, it's been coming out in quite a narrative style, in the first person plural ("Let's look at our tables - we've got...", "Why should we design in this way?..."). Before doing too much more, I thought it'd be a better idea to check how we want the book to read - is it to be a "dry" technical manual type of book, or is it going to be a more "human", narrative type of book? At least if we can decide this it will make the editors' job easier if we all start in a vaguely similar style.

I'd say more "human".

Even though I read all the posts on this topic I can't remember all of them (heck it's 16 pages already), so I'm sorry if someone has already suggested what I'm going to suggest...
I believe we need a "Code Layout/Convention" chapter... Something like phpBB's Coding Guidelines

For example I prefer this:
Syntax: [ Download ] [ Hide ]
function my_function()

{

        // Code goes here

}

Over this:
Syntax: [ Download ] [ Hide ]
function my_function() {

        // Code goes here

}


Another convention is to use uppercase letters for constant names, and there many others...


Top
 Profile  
 
 Post subject:
PostPosted: Tue Jul 11, 2006 6:04 am 
Offline
Breakbeat Nuttzer
User avatar

Joined: Wed Mar 24, 2004 8:57 am
Posts: 13098
Location: Melbourne, Australia
feyd wrote:
A usergroup and forum have been created for this endevour. Chris, d11wtq, is the owner of said usergroup. The board is, right now, only visible to that group and the moderators. If the group wishes to change this visibility or permissions layout, that is fine. This is just a starting point.


w00t! Cheers buddy :)

EDIT | Later today (I'm at work right now) I'll create some stickies for what the project is about and it's objective. I'll then try to split off posts from this mammoth thread for discussion on "Contents" and "Licensing/Copyright".

EDIT 2 | For anybody who can't see the forum and unsure how to become a member of the group just go to "Usergroups" at the top of the page, select the "Community Composition Contributors" group and subscribe to it... I'll approve them regularly and once you're approved you'll have access to the Board.


Top
 Profile  
 
 Post subject:
PostPosted: Tue Jul 11, 2006 7:32 am 
Offline
Forum Contributor
User avatar

Joined: Tue Apr 13, 2004 12:51 am
Posts: 239
Location: Prague (CZ) / Vienna (A)
I must have missed this topic..
I would of course love to help as I can, although I'm not sure if my programming skills are good enough to teach someone :P But if there's any work I could be able to help with, I'd be glad to do so.

:D


Top
 Profile  
 
 Post subject:
PostPosted: Tue Jul 11, 2006 8:56 am 
Offline
Site Administrator
User avatar

Joined: Tue Sep 09, 2003 6:04 pm
Posts: 14293
Location: Fremont, CA, USA
d11wtq wrote:
EDIT | Later today (I'm at work right now) I'll create some stickies for what the project is about and it's objective. I'll then try to split off posts from this mammoth thread for discussion on "Contents" and "Licensing/Copyright".

EDIT 2 | For anybody who can't see the forum and unsure how to become a member of the group just go to "Usergroups" at the top of the page, select the "Community Composition Contributors" group and subscribe to it... I'll approve them regularly and once you're approved you'll have access to the Board.


Sorry d11, I may have overstepped my bounds. I created two posts in the BK forum. One for licensing, the other for copyright. I was thinking that we may want a thread for suggestions, style, included topics, etc. If I went overboard, please moderate accordingly.

PS I hadn't read this before posting in that forum. I apologize if I got ahead of myself.


Top
 Profile  
 
 Post subject:
PostPosted: Tue Jul 11, 2006 10:04 am 
Offline
Breakbeat Nuttzer
User avatar

Joined: Wed Mar 24, 2004 8:57 am
Posts: 13098
Location: Melbourne, Australia
Everah wrote:
d11wtq wrote:
EDIT | Later today (I'm at work right now) I'll create some stickies for what the project is about and it's objective. I'll then try to split off posts from this mammoth thread for discussion on "Contents" and "Licensing/Copyright".

EDIT 2 | For anybody who can't see the forum and unsure how to become a member of the group just go to "Usergroups" at the top of the page, select the "Community Composition Contributors" group and subscribe to it... I'll approve them regularly and once you're approved you'll have access to the Board.


Sorry d11, I may have overstepped my bounds. I created two posts in the BK forum. One for licensing, the other for copyright. I was thinking that we may want a thread for suggestions, style, included topics, etc. If I went overboard, please moderate accordingly.

PS I hadn't read this before posting in that forum. I apologize if I got ahead of myself.


That's cool :) Saves me a job anyway :P Thanks.


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 2:31 pm 
Offline
DevNet Master
User avatar

Joined: Tue Dec 28, 2004 6:57 pm
Posts: 2745
Location: Tallinn, Estonia
been a while since anyone posted here but...

Whats happening with this? I registered on the wiki but there seams to be very little going on. Maybe the preface should be started? Start the chapters that are there so far (the order of them is questionable but that really does not matter). Also maybe a 'this is how you should write a segment in a chapter' thing so people don't start writing stuff that does not go with the standard of the book?

It would be cool to see this go through instead of being forgotten like some other devnet projects that took off real quick then died just as fast...


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 2:42 pm 
Offline
DevNet Resident
User avatar

Joined: Fri Apr 07, 2006 5:13 am
Posts: 1640
Location: Israel
Yeah, that's right. What's going on? I don't want to spend hours on writing just to find out that nobody else is doing anything and the project is dying :cry:


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 3:18 pm 
Offline
Breakbeat Nuttzer
User avatar

Joined: Wed Mar 24, 2004 8:57 am
Posts: 13098
Location: Melbourne, Australia
Oren wrote:
Yeah, that's right. What's going on? I don't want to spend hours on writing just to find out that nobody else is doing anything and the project is dying :cry:


Hey.... I'll do this by myself if nobody else wants to help out :evil:

I do have to say I'm feeling a little disappointed at what seems to be a lack of interest in people actually writing content :( Everyone seemed so enthusiastic in the discussions. I'm sure a select few of us will tread along with start to finish anyway. Some people are on holiday/busy at the moment too so things will have slow patches.

Dig in! I keep saying it.... really, just chip away at it... we can only rewrite/improve what you do if people are concerned that their contributions will not be suitable ;)


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 3:24 pm 
Offline
Site Administrator
User avatar

Joined: Wed Aug 25, 2004 7:54 pm
Posts: 12723
Location: New York, NY, US
I have to say that I have not been writing content because I didn't feel the structure was done yet. I had proposed an alternate section/chapter layout that some people liked, but has not been blessed as the direction to go by the project leads. Nor has any chapter layout been discussed in detail to get to a more finalized set of sections/chapters, from what I have seen. I assumed that that was the next step after the name and license discussions.

_________________
(#10850)


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 3:51 pm 
Offline
Site Administrator
User avatar

Joined: Tue Sep 09, 2003 6:04 pm
Posts: 14293
Location: Fremont, CA, USA
It appeared at first that Maugrim's layout was what we going with. Then Arborint came up with some good additions to it.

I have started writing the intros and purpose and such. I will try to get some more up tonight if I can. Maybe we can a few contributors to work on the chapter layouts while some of the other contributors work on content for the earlier, non technical sections. If we team up on this monster we can take her down quicker, eh?


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 6:17 pm 
Offline
Breakbeat Nuttzer
User avatar

Joined: Wed Mar 24, 2004 8:57 am
Posts: 13098
Location: Melbourne, Australia
Everah wrote:
If we team up on this monster we can take her down quicker, eh?


Exactly.

~arborint. Sorry about the contents thing. There's obviously been a bit of confusion on my part there since I thought we were pretty much just using the wiki to change the contents ourselves.

Let's bring the contents discussion back to the surface in our little forum then :)


Top
 Profile  
 
 Post subject:
PostPosted: Tue Aug 08, 2006 6:28 pm 
Offline
Site Administrator
User avatar

Joined: Wed Aug 25, 2004 7:54 pm
Posts: 12723
Location: New York, NY, US
d11wtq wrote:
Let's bring the contents discussion back to the surface in our little forum then :)

I already have here:

http://forums.devnetwork.net/viewtopic. ... 9&start=38

I still think it needs some work

- The linear tutorial chapters need to be clearer about the progression and to create parallel tracks in the Intro and Intermediate tracks.
- The random access chapters need to be filled out, thought through, etc.

_________________
(#10850)


Top
 Profile  
 
 Post subject:
PostPosted: Wed Aug 09, 2006 12:59 am 
Offline
DevNet Resident
User avatar

Joined: Thu Feb 09, 2006 5:52 pm
Posts: 1925
Location: everett, wa
I still want to help. I have been working 70+ hours a week lately, though.


Top
 Profile  
 
 Post subject:
PostPosted: Sat Sep 02, 2006 5:36 am 
Offline
Forum Regular

Joined: Tue Jul 05, 2005 3:54 am
Posts: 945
Location: Sofia, Bulgaria
Hi,
I think The Decorator pattern explained at

http://phpbook.quantum-star.com/doku.ph ... _decorator

has some design flaws...which more or less defeats the purpose of the design pattern. Since, I kind of don't want to search in 13 page thread...has this issue been discussed?
If not...I will provide a version I believe is more accurate.


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 268 posts ]  Go to page Previous  1 ... 13, 14, 15, 16, 17, 18  Next

All times are UTC - 5 hours


Who is online

Users browsing this forum: No registered users and 3 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Jump to:  
Powered by phpBB® Forum Software © phpBB Group