Create code guidelines for contributions

DesignOpen / designopen.github.io

Homepage

http://opendesign.foundation

Creative Commons Zero v1.0 Universal

163 stars 25 forks source link

Create code guidelines for contributions #76

Open GarthDB opened 10 years ago

GarthDB commented 10 years ago

From something @terracomma mentioned in another issue.

GarthDB commented 10 years ago

Just some initial thoughts.

All custom pages need to:

scale responsively on small screens
be optimized for performance (let's use Pagespeed Insights)
use structured data (I think http://schema.org/ would be best)
include the comments section
include site navigation https://github.com/opensourcedesignis/opensourcedesignis.github.io/issues/77

Moodycomputer commented 10 years ago

I've never used schema.org before. What are the advantages of that vs carefully chosen tags?

GarthDB commented 10 years ago

You can apply it to any tags as attributes. It just is more semantic than HTML alone and search engines use it to better understand the structure of a website.

Moodycomputer commented 10 years ago

Sounds good, I'll start reading up on it.

GarthDB commented 10 years ago

@terracomma good place to start https://support.google.com/webmasters/answer/99170?hl=en

Moodycomputer commented 10 years ago

We should probably declare our browser support too. I suggest current -2 for Chrome, FF and Safari.

GarthDB commented 10 years ago

good call I don't have ie to test but we would accept contributions on it.

GarthDB commented 10 years ago

I don't mind being a bit more bleeding edge.

Moodycomputer commented 10 years ago

I agree. If someone wants to IE fix all our stuff, by all means we'll accept it. But I would love to not write it myself.