Suggestion: introduction block about frontend-guidelines HOT 7 CLOSED

I agree with this - explaining "why" is key when it comes to resources that are meant to be learnt from. If this isn't feasible, you should probably include a notice stating that these are merely suggestions based on personal opinions, and these guidelines are not intended to be a definitive guide to good practice, nor something that beginners should be learning from.

from frontend-guidelines.

I also agree with above suggestion. We have a very good example of John Papa's AngularJs Style guide which explain his relational behind every given style guideline.

from frontend-guidelines.

I definitely agree with this suggestion, I feel like a lot of developers can easily become dissuaded by the advice that you're giving without proper context of why these are good decisions or proper guidelines.

from frontend-guidelines.

I just want to comment - I am a new web developer of sorts, and read this. I was in fact quite dissuaded by several things as @conwaydev suggested might be the case.

from frontend-guidelines.

It'd be wise to specify who your audience is as well. As mentioned in #26 the Javascript section uses ES6 features that aren't going to be available unless you use a transpiler. It's a valid argument that ES6 is the future of Javascript and should be used when possible, but I don't think it's safe to assume that the average beginner is going to be as comfortable understanding ES5 vs ES6, the current state of browser implementations, why a transpilier is needed at the moment, etc.

The guide covers some really basic front-end concepts in CSS/HTML yet you're assuming a lot of the reader here when it comes to Javascript. It just doesn't seem like its being consistent with its expectations of the reader.

The best option, I'd say, is to create an introduction explaining the target audience and expected level of competence. Outline which features here are non-standard within the current browser environment (this is a front-end guide after all, not a guide on the current Javascript standard) and how they can be used now via something like Babel.

from frontend-guidelines.

I agree with all previous commenters and think a disclaimer of sorts should be mandatory.

Your points make sense to an experienced developer. Or at least she will understand what your tradeoffs are. To a new developer some points probably seem arbitrary, ie.

Avoid animating other properties than opacity and transform.

Why? What's wrong with color? Why is margin-left bad and translateX good?

from frontend-guidelines.

@prayerslayer Because opacity and transform are the only properties fast to animate.

Closing this issue but keeping this suggestion in mind :)

from frontend-guidelines.