Google merge

[cirosantilli]

Initial talk: https://twitter.com/nodir_turakulov/status/646116981188526080

License: finally I've decided to license this under CC BY-SA . I've seen that Google's style is CC BY, so I think we can't merge? I feel not going SA doesn't make much sense: why let others build on this if they don't share back freely? Let me know if you have any toughs on this, this is the first time I pick a license :-) Does Google use BY-SA at all, or is there a policy against it?

I think it would be easier to merge Google's diff into my style :-)

Take a look at what I've got, and if you disagree with anything, tell me.

Points covered by Google style and not covered here:

• Document layout
• links: descriptive text, shortened (TODO how: link shortener services like goo.gl or [][] links?)
• images: use few
• code blocks: trailing backslash for Bash

Comments:

• "Indented codeblocks are sometimes cleaner": I'd remove that as it makes the guide harder to follow. Better say: use only fenced, or use only indented. Otherwise people will use whatever they want.
• "Prefer lists to tables": while that is true, consider that with some tooling, it becomes feasible to maintain huge tables. For example, I'm using https://github.com/plasticboy/vim-markdown/blob/5ff124014066ba7882617c283e7750d449caafb4/ftplugin/markdown.vim#L393 which I implemented to maintain tables such as https://github.com/cirosantilli/cirosantilli.github.io/blob/62a2fccf23a6ab322092433d516ed8504f4d5223/projects.md#merged-by-others

[nodirt]

https://github.com/google/styleguide/tree/gh-pages/docguide is stripped version of google-internal guide. It is supposed to be as close to the original as possible, but not expose confidential stuff, so external contributions would make the style guide diverge, and hard to sync. Sorry.