 | News Feed |
 | Jobs Feed |
Sections
|
| feed this: |  |
Paul Reinheimer's Blog: Improving See Also
by Chris Cornutt August 06, 2008 @ 10:26:42
Paul Reinheimer has a suggestion on how to improve the PHP manual to be an even better resource - enhancing the "see also".
Something I'd like to see in PHP is a little more in the See Also section. They're pretty good, but it's not quite as spider-web like as I'd like. For example, yesterday I added a few links from md5() and sha1() to hash(). Lot of people know about md5() and sha1() within PHP, but I find hash() is rather unknown overall, which is a pity as it exposes a tone of different hashing algorithms.
You can see an example of his updates in the md5 manual page linking it to sha1_file, crc32, sha1 and the hash functions.
voice your opinion now!
seealso manual link sha1 hash documentation team
Chris Hartjes' Blog: What Is Really Considered Documentation?
by Chris Cornutt July 23, 2008 @ 10:26:33
In this new post, Chris Hartjes takes a look at something that is one of the banes of most programmers' existence - documentation. In it he wonders what should really be considered documentation and the importance of it.
As a committed user of open source technologies, the difference between me using something and not using something is the documentation. Is there documentation for it? Is it easy to find? Does it answer my questions? Is there someone I can call an idiot if I disagree with the level of documentation? These are all very important questions.
He uses the illustration of the documentation of the CakePHP framework that's helpful, but only really after you learn how to use the framework in the first place. He mentions people on both sides of the fence - those that love the framework and love the documentation and those that moved on to something simpler because they just couldn't get it.
He also mentions the variety of sources that can provide "documentation" for the framework when you're getting a bit stuck - everything from blogs to The Bakery to a different sort of documentation, unit test.
voice your opinion now!
consider documentation types cakephp example unittest manual blog
Ibuildings Blog: About Open Source software projects
by Chris Cornutt July 22, 2008 @ 10:27:15
On the Ibuildings blog today Mikko Koppanen talks a bit about Open Source software projects and things that can help to make them successful.
An idea can be a tool or a library that you need and think others might find useful; a new technology innovation; or something you think you could implement better than the existing tools. Extra care has to be taken if you decide to create a new tool to replace an old one. In most cases, these projects end up reinventing the wheel without any added value. A wheel is wheel, right?
He recommends a team infrastructure growth as the application grows and the importance of documentation and maintenance after the project has been launched.
voice your opinion now!
opensource software project manage team infrastructure documentation maintenance
Fred Wu's Blog: Zend Framework, where do you want to go tomorrow?
by Chris Cornutt July 11, 2008 @ 11:19:19
Fred Wu recently posted some of his thoughts on using the Zend Framework as a developer in other frameworks looking to expand his knowledge.
When Zend Framework was first announced, the developers have promised us one thing: extreme simplicity. I was 'extremely' excited, but it turned out that it wasn't the case. Ironically, Zend Framework is the most difficult one I have come crossed so far. I mean, as complicated as Symfony is, it has brilliant documentation and an active community to back it up.
He also comments on the level of documentation the framework has ("the documentation is often outdated, sometimes inaccurate"), the Zend_Search_Lucene component, some of what he thinks are missing components that should be in a 1.5 release, and a last jab at the naming conventions.
voice your opinion now!
zendframework beginner firstlook extreme simplicity documentation component
Chris Hartjes' Blog: Cooking Up Some Cake
by Chris Cornutt February 19, 2008 @ 10:27:00
Chris Hartjes has posted about a new resource that he "cannot stop recommending people to use [it] when searching for answers to their CakePHP problems" - the CakePHP Cookbook.
With a ton of help from Andy Dawson (AD7Six) the documentation for CakePHP 1.2 has moved forward immensely with the unveiling of the CakePHP Cookbook. It's a combination of manual and wiki, where people can flesh out the manual and make comments on the methods in there.
With the wiki in place, anyone can add to the communal CakePHP wisdom (or correct where others might have strayed) to make it a bigger and better resource for the whole range of CakePHP developers.
voice your opinion now!
cakephp documentation wiki manual cookbook book
|
Community Events
Don't see your event here? Let us know!
|