Issues

ZF-691: Coding Standards Version 1.0

Issue Type: Docs: Task Created: 2006-12-27T13:25:19.000+0000 Last Updated: 2012-11-20T21:38:13.000+0000 Status: Open Fix version(s): - Next Major Release ()

Reporter: Ralph Schindler (ralph) Assignee: None Tags: Related issues: - ZF-507

Attachments:

Description

Concerning the document located here:

http://framework.zend.com/wiki/x/PQ

We should should round out the details of this document and get it beyond release candidate and move it into the documentation.

A few things that need to be added or addressed: * Standard stock doc blocks for copy and paste purposes (page docblock, class docblock) * A more definitive guide on doc blocking... aim to standardize * Exception section updated to current standards * [other isses will be attached to this one]

Once this document is finalized (V1), i propose we evaluate all production (non-incubator code) and clean it up per the standards.

Comments

Posted by Darby Felton (darby) on 2007-12-26T10:13:36.000+0000

Updated link

Posted by Darby Felton (darby) on 2007-12-31T06:49:31.000+0000

We might want to address array keys (e.g., component options) in the coding standard. A camelCase standard would correspond with already adopted variable and method naming conventions, though we would need a backward compatibility layer for many components that use the under_score naming convention for array keys.

Posted by Ralph Schindler (ralph) on 2008-03-21T10:47:23.000+0000

We should include View Script (as well as Application code, Bootstrapping code, or any user code) best practices in this documentation.

Perhaps we should have a split in this document.

Part 1 would be for library coding standards Part 2 would be for application coding standards

Posted by Thomas Weidner (thomas) on 2008-03-21T16:29:55.000+0000

There should also be a standard for API docblocks. The actual situation is a quirks because everyone does his own.

Regarding coding standards in general it would be great to have a tool which does the check and returns standard-breaks to be fixed. But it should met ZF standard... a sort of modified phpbeautifier ;-)

Posted by Wil Sinclair (wil) on 2008-03-25T22:02:49.000+0000

Resetting 'fix version priority' and 'fix version' to be re-evaluated for next release.

Posted by Thomas Weidner (thomas) on 2008-04-08T01:37:35.000+0000

For completeness the draft for the new standard can be found here: http://framework.zend.com/wiki/display/…

Posted by Wil Sinclair (wil) on 2008-04-24T12:34:23.000+0000

Status? And if Thomas is doing work on this, let's break out his tasks in to subtasks and assign them to him.

Posted by Thomas Weidner (thomas) on 2008-04-24T13:36:52.000+0000

I've already created the CodeSniffer ruleset based on the old PHP Coding Standard from Darby and the new ZF Coding Standard from Ralph and me.

You can already try it out in the incubator under "tools". Actually it finds about 160.000 errors and is very strict in it's tests. It's not 100% finished but it gives already a good overview.

Posted by Wil Sinclair (wil) on 2008-06-15T21:24:07.000+0000

Updating to comply with new IT component conventions.

Posted by Ralph Schindler (ralph) on 2009-01-09T11:57:37.000+0000

reassigning

Have you found an issue?

See the Overview section for more details.

Copyright

© 2006-2016 by Zend, a Rogue Wave Company. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.

Contacts