Fixed code example (2)

[wouterj]

This is, or at least I hope it is, the last PR for fixing the code standards. I have fixed the bash code examples and I have added the standards to contributing/documentation/overview.

Please take a look at the standards, I think most of them are written in really worse english. Please ask me questions if you don't understand the sentence.

Sorry for the last 5 commits, ReSt isn't my best format language...

[stof]

this one is not used

[wouterj]

Good catch! It was used but then I switched to a :doc: link. I will remove it.

[weaverryan]

Hey there!

This is an excellent start to the coding standards for the docs - a lot of this has never really been formalized until now. If the community decides differently on any of these standards, we may tweak them over time, but having them concretely is excellent!

I did make some tweaks to your standards section - but all tiny things.

Thanks!

[wouterj]

Thank you @weaverryan ! The original text was writen in Markdown (for this PR system) and I forgot to change the inline code blocks!

The only thing I disagree is the public before the function. It isn't in a class scope and when it is you should place a // ... in front of it, I think.

And maybe the max. line length rule? Nobody knows that and there first PR.

Does anyone know why this don't appear at the symfony website? ( http://symfony.com/doc/current/contributing/documentation/overview.html )

[weaverryan]

@wouterj the problem with the public is that we really don't ever use flat functions anywhere - only methods, so the example isn't really useful unless it's a class method. I've tweaked things at sha: aae3a5f and sha: 4f8ff0e

Let me know if you see any changes needed. I'm not sure why things aren't rendered yet - the docs haven't been rendering as quickly lately as they normally do.

[wouterj]

@weaverryan it looks great now! Thank you!

I will check the code examples that are new in the master branch and create the last PR for this... (finally)