Hall of Famer Posted November 30, 2012 Share Posted November 30, 2012 For me its definitely PHP4 code. Come on its been more than 8 years and some libs are still trying to be friendly and compatible with this old dinasour. Link to comment https://forums.phpfreaks.com/topic/271421-whats-do-you-find-frustrating-in-a-third-party-script/ Share on other sites More sharing options...
KevinM1 Posted November 30, 2012 Share Posted November 30, 2012 A lack of complete and up-to-date documentation. Even enterprise products like Symfony suffer from it. It seems like with just about every OSS project the lead developer is also the doc writer, so invariably some of the critical, but basic, steps for a new user to use the product correctly are either glossed over or not mentioned at all because of their intimate familiarity with what they're creating. It's incredibly frustrating to follow documentation 100% correctly only for the product to not work or spit out a confusing exception. Link to comment https://forums.phpfreaks.com/topic/271421-whats-do-you-find-frustrating-in-a-third-party-script/#findComment-1396551 Share on other sites More sharing options...
Philip Posted November 30, 2012 Share Posted November 30, 2012 On 11/30/2012 at 9:26 PM, KevinM1 said: A lack of complete and up-to-date documentation. Even enterprise products like Symfony suffer from it. It seems like with just about every OSS project the lead developer is also the doc writer, so invariably some of the critical, but basic, steps for a new user to use the product correctly are either glossed over or not mentioned at all because of their intimate familiarity with what they're creating. It's incredibly frustrating to follow documentation 100% correctly only for the product to not work or spit out a confusing exception. +10000 Link to comment https://forums.phpfreaks.com/topic/271421-whats-do-you-find-frustrating-in-a-third-party-script/#findComment-1396567 Share on other sites More sharing options...
DavidAM Posted December 1, 2012 Share Posted December 1, 2012 Documentation and/or Online Help that just repeats the field label. Form: Port Number: ______ Protocol: _____ Help File: Port Number: Enter the Port Number Protocol: Enter the using Protocol (and stupid grammatical errors) Link to comment https://forums.phpfreaks.com/topic/271421-whats-do-you-find-frustrating-in-a-third-party-script/#findComment-1396597 Share on other sites More sharing options...
Christian F. Posted December 1, 2012 Share Posted December 1, 2012 After just finished on working on a third party system forked from OSC, and the Amazon API, I can only agree with the following: On 11/30/2012 at 9:26 PM, KevinM1 said: A lack of complete and up-to-date documentation. Even enterprise products like Symfony suffer from it. It seems like with just about every OSS project the lead developer is also the doc writer, so invariably some of the critical, but basic, steps for a new user to use the product correctly are either glossed over or not mentioned at all because of their intimate familiarity with what they're creating. It's incredibly frustrating to follow documentation 100% correctly only for the product to not work or spit out a confusing exception. It's almost worse to have documentation that gets some of the stuff wrong, but others correct. That way you never know whether or not you can actually trust it, or if you need to just chuck it all into the deepest recesses of /dev/null as you can get. When you don't have any documentation, you know that what you can observe from the code is always going to be the correct behaviour, at least. But the MS-Help (which I've dubbed it) exemplified by DavidAM above is also a pet-peeve of mine. Unfortunately often found in abundance in most documentations. Link to comment https://forums.phpfreaks.com/topic/271421-whats-do-you-find-frustrating-in-a-third-party-script/#findComment-1396624 Share on other sites More sharing options...
Recommended Posts
Archived
This topic is now archived and is closed to further replies.