i don’t know if you can do this,
but i hope u add support for documentation to be visible without leaving the code editor (monodevelop, sharpDevelop, visual studio), i hope you make the documentation visible in a way similar to java, where you can read everything about each function in the explanation popup that is displayed.
this is far more effecient than moving to a webpage to see the docs.

“User Contributes Notes” will be the only satisfying solution in my opinion.

php.net manual is in my opinion a true reflection and appreciation of what a community can bring on the table with “User Contributes Notes”. With moderation and letting people vote up and down comments, so there is NOTHING to loose in making this available.

On the topic of documentation.
It would be really great if Unity could update all forum and answer posts that point to the old unifycommunity dot com site to the http://wiki.unity3d.com/ address instead.

I realise that these are comments made by the community (and some of them long ago) and not Unity Technologies however it would be possible for someone to buy the old domain and trick users into providing their Unity account details.

Wish you guys would finish all of the Unity 4 milestones before offering Unity 5. I’m still waiting on Unity 4 features that are in beta. Does this mean outstanding Unity 5 features will arrive when a new Unity 6 preorder surfaces? I really don’t like this refocusing trend.

Awesome, would love to get some information about possible Exceptions when calling methods, sometimes I get C++ errors that make no sense and trying to Debug those are very hard to do. Knowing what could potentially go wrong with a method given bad data would help debugging.

Unity is CommUnity. Unity’s greatest asset is it’s community. The direct input from the community has shaped Unity into the product it is today. This is how Unity becomes successful. I hope this feature finds it’s way back into the docs soon. And thanks for the post.

As for the c# vs unityscript argument, I thought that was settled a few blogs posts back? :-P

Correct, and as many of the other comments to this post also points out, as well as the feedback we get specifically on the documentation (even without the “Suggest a change” feature enabled), we see a big interest from you in the community for the documentation, and we are looking at ways to involve the community in improving our documentation. Right now focus however is shipping a great Unity 5, and then we’ll find out how to open the docs for community contributions.

Have you thought about adding other community features?
I’d love unity to integrate more with the open source movement. A way for users to push to the asset store via a repository on github would be awesome.
Who says you always have to pay for good code :P

Glad unity is adding systems to improve the docs. unity docs are already some of the best out there but it is annoying to find java code and have to convert it over manually. one thing that would be nice is if we had access to the code converter as well. i know tutorial guys would prolly like to give example code in both languages. as well as java coders trying to understand c# would benefit.

We should rather allow the documentation to be changed by the community.

Allow us to make any changes/corrections, which can then be approved by a documentation manager of some sort. This will make it far more extensive, and allow us to share our thoughts and insights and experiences.

Nice analysis on feedback. What about making “Suggest a change” permanent option for all documentation pages? It would give long term feedback with much stronger arguments.

Talking about long term documentation I think making it with “wiki” principals would be really nice approach. In that case developers would be able to suggest directly their version of changes and articles would get more likely updated all the time.

no, no, this discussion definitely belongs here –
Web background has absolutely nothing to do with Unityscript except for very small overlap in syntax, which can be often even misleading
any former web developer thinking that Unityscript will somehow ease the development in Unity is sadly mistaken

I agree. I came to Unity from a Flash, Art, and Web Design background so I’m very comfortable with JavaScript. I’m sure C# has better performance but I’m glad we have the option to use both. I think that kind of choice and openness is part of what makes Unity so accessible.

Both C# and Unity script are important.
I came from as and started with unity script. A couple months later I changed to c# as I liked the benefits of the language.
Unity script is important to keep as it keeps new users happy and is great for rapid development.
C# is important due to its features that unityscript doesn’t have.
Unfortunalty it’s not worthwhile to keep the standard assets up to date in both languages so some people will be upset. The best thing unity can do is keep the scripts encapsulated so you don’t have compilation script orders issues which unity have done pretty well so far on their assets.

C# and Visual Studio’s intellisense makes developing in C# far more efficient than using UnityScript, which has no decent intellisense support.

Add in Resharper and your productivity is easily 50% – 100% more than anything you’d ever get with UnityScript. So for all these people who think UnityScript in some kind of weird strange way is ‘faster’ or ‘quicker to learn’ than C# has no idea.

I think the switch to C# as the default is a GREAT move. There’s nothing that annoys me more than getting a client project that someone else worked on first and it’s in UnityScript. Since the code samples on the web and the code completion for C# is far superior it just makes it very difficult to work on a project who’s code is all in UnityScript. This will likely cause most newcomers to start off with C#. Thanks! :)

First!! :D Well… I think this is awesome! I always read and use the unity documentation and I do notice at times that some of the documentation is unclear but… I deal with it just because Unity is awesome sauce. :)