I've been using Doctrine since a long time, and always felt the documentation is one its weakest spot. I've no problems myself looking in stackoverflow, irc and even looking at the code directly, but, my coworkers tend to ask me a lot just because the documentation isn't there or is to complicated or vague.
Is there a way I can contribute to Doctrine documentation, btw I haven't found nothing about that in the site, hence this question :S
The documentation is in the git repository over at github. Fork the repo, make changes/additions, and send pull requests.
Related
I would like to contribute to Nextcloud because there are some issues that are quite easily fixed but aren't by the developers.
Now this might sound like a stupid question, but I can't find ANY information on how the code is structured. There is no documentation I could find whatsoever.
I also can't find any information of other people developing with Nextcloud as issues on Github are not answered.
Is there any information available or is it only Open Source in the sense that all structure is kept private by Nextcloud GmbH and only the code is made public?
Specifically I am looking for information on which Vue.js component does what and where I would have to look to find the functions that are doing what I'm searching for.
I'm looking for a "good" PHP framework to suit my needs:
well-documented, preferably with a handful of beginner tutorials (majorly, majorly important.. I looked at Kohana and felt like I wouldn't be able to jump in with both feet and learn it)
fairly solid community (either here on Stack Overflow, or on a forum) for questions, etc
stable and time-tested
greatly reduces amount of code/coding (e.g. what jQuery does for JavaScript)
I'm pretty solid at PHP, I'm just looking for something that will help speed up the development process, handle cleansing input from users, simplify database queries, that sort of thing. MVC and OO is nice, but not exactly a requirement for me.
Have you take a look at symfony?
Symfony (version 1 or 2 - doesn't matter) has a great documentation (with a book to guide you building a web, a book showing you how the framework works, and the usual API documentation). Check here for the full documentation of symfony1 and symfony2.
Symfony2 is rather new, so while I can say it's stable (I'm using it and quite sure it is), time-tested-ness (is that a word? :p) is not so good. But if you want a stable and time-tested, you could try symfony1, because it's still supported until 2013.
The symfony community is also great, both the user community and the developers. Stackoverflow also has many good symfony users, and you can check their mailing list and other resources here.
As for reducing amount of code, symfony comes with a lot of standard library, ORM, and many code-generation tool (usually called from command line). So yeah, it save so many code. In symfony1, you can even generate a CRUD application without a single line of code written by you. I know you also can do this in symfony2, but I haven't tried it yet. You can be sure that you will more focused on coding your business logic well than fighting the framework.
Hope this helps.
Can you guys provide some good tutorials on symfony? Simple stuff, nothing really big and well-detailed, like the Jobeet tutorial. A crash course, maybe some video tutorials too.
I'd recommend starting with the Getting Started tutorial.
Aside from the Jobeet tutorials, the other tutorials you will find online will deal mostly with specifics. If you want an introduction to the framework, there is no better documentation than the ones provided by sensio labs.
http://www.symfony-project.org/doc/1_4/
Another good resource, is the #symfony channel on Freenode. If you have any questions, that channel is quite active and helpful.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
Questions asking us to recommend or find a tool, library or favorite off-site resource are off-topic for Stack Overflow as they tend to attract opinionated answers and spam. Instead, describe the problem and what has been done so far to solve it.
Closed 9 years ago.
Improve this question
I've been searching for a framework for the past couple weeks and I must say it's not bee very good.
So far I've tried
Code Igniter
Kohana
Dingo
Looked at (started to try)
Symphony
Yii
and read up on many others but I can't seem to find one that I find usable.
Usable for me being simplistic in the CI and Kohana sense, i.e more minimalist. The listed frameworks are those I like but I can't get a feel for Yii and Symphony.
CI feels a little verbose especially when compared to Dingo but both Dingo and Kohana and underdocumented which is a majour turnoff.
From what I can see out there, the frameworks that people like to recommend are not well documented, e.g picking on Kohana, the available documentation is totally useless because it's not for the latest release it just leave the feeling that people don't actually use these things.
Some that looked good but dead or will likely die:
Recess
Not sure What's hapenning with Doo
So to the main question: What are some PHP frameworks that are well documented, lightweight(No Cake, Zend) and that people actually use?
Personally, I really like Lithium. It's 5.3 only, but it's really powerful. It's architected REALLY well (IMHO) and is fairly light. But it does fail your documentation test (And fail hard at that). But I have found that the devs do hang out on IRC and are pretty accepting of new users, so if you don't understand something, there is a source for answers...
I personally use the Nette framework - clean, small, extremely useful, you can use only the parts of it you like and a very good documentation: http://nette.org/en/
The best compromise (yes I said compromise) between features, documentation, and community, is Yii.
I will give you a simple exercise wich I think is representative of the general experience you will have with each respective framework: try to implement htmlpurifyer in Yii, kohana, etc. (I wanted to implement it for real, not as an exerise, but I think the experience is representative).
With google I found a topic on the yii forum about htmlpurifyer. I also found one in the kohana forum. At first glance no big difference, but once you actually try to implement and use it, aaaa, big difference.
In yii it is all served up on a silver platter, including htmlpurifier configurations.
In kohana, there is a module on github for it, but it is missing configurations for htmlpurifier, and missing examples of how you actually purify a variable - try figuring that one out on your own.
In codeigniter, you will probably have to do everything from scratch.
Kohana has cleaner coding style / architecture, but the lack of documewntation is crippling (this could be solved if you arent shy about using their forum... EVERY DAY - THIS IS NOT A JOKE). You will make fast progress for a while in your develpopment with kohana and be really impressed an pleased with it, and then hit a deadspot in the documentation (including google), and all the time you gained untill now, and all thew joy will be tripply lost on the issue you hit because of the lack of documentation.
This problem will never go away in my opinion (unfortunately), because alot of the contributions from the community to Kohana (modules and stuff) are made in github style, with the only documentation being a short introduction (at best).
In order for this problem to go away, the devs would have to encourage somehow the contributors to up their documentation standard. But this isnt going to happen because the devs themselves use the same style of contribution to kohana (github projects with sparse documentation). So even if tthey fix the main documentation, and make it 100% bulletproof, there will still be the comunity contributions which will have bad docs, or you will have to create the whole module from scratch yourself.
I would say Zend has grown tremendously to be one of the front line framework to be used. I have also pointed out few more competitive frameworks here which have good documentation, support and also considering the light weight factor of the framework.
I have been reading that Kohana is good for my project. So now I want to get started. My PHP knowledge is 2 years old and very limited now. But I am experienced with object oriented programming and other patterns, since I develop in Objective-C. I know a little bit about databases.
People told me the Kohana documentation is horribly poor. So, where do I start as a newcommer?
this might not be the best way but
1. i watched the 2 tutorial videos on the codeignitor framework and tried a small example
2. i switched to kohana and tried the same thing and haven't looked back
i am quite familiar with php, so your mileage may vary
You'll definately want to start from the Kohana 101 wiki.
You may find it here.
As mentioned by petsagouris, the 101 wiki is a good resource for seeing examples of how to use the framework. It's also worth reading the docs as well. Even though they aren't as good as CI's they still contain a lot of useful information.
However if you want to get the most from the framework I recommend you invest a couple of hours looking through the code of the classes that you use (e.g. Kohana, ORM and if you're feeling brave, Database).
The files are very well documented and the experience will help you solve problems more quickly as you will know how Kohana works, and where to look if something isn't quite working as you expected.
If you want to avoid the pain of setting up the initial environment, I have released a vagrant dev environment with a base checkout of Kohana 3.3.1. Jumping right into the code is usually the best way to go. Hopefully this helps.
Intro to Vagrant with Kohana and Zen Kommerce