18F / development-guide

A set of guidelines and best practices for an awesome software engineering team
https://engineering.18f.gov
Other
1.25k stars 122 forks source link

Update JS framework page #134

Closed mgwalker closed 4 years ago

mgwalker commented 4 years ago

Makes a first pass at updating the JS frameworks page

Will eventually close #133

cantsin commented 4 years ago

Had this on my todo list for awhile, finally getting around to this! My 2c:

(Wanted to start a discussion and come to some agreement before pushing content to this PR)

mgwalker commented 4 years ago

That is great and exactly what I was hoping for. If we're going to deprecate something, it's good to be able to say why.

I like your point about jQuery too. So maybe we say something like don't use jQuery yourself, but don't disqualify a framework that uses it under the hood?

cantsin commented 4 years ago

Re: jQuery, absolutely agree. What's the next step: do you want me to push up some wording to this PR or...?

ryanhofdotgov commented 4 years ago

Just an editorial thought – these library/framework type pages could become dominated by deprecated entries as technology marches on.

In the spirit of "less is more", I might lean towards documenting many/most of the deprecation reasons in the change history/issues, and keeping the content focused.

mgwalker commented 4 years ago

@ryanhofdotgov That makes sense. Maybe we can just list them as they age-out, keep them for a little while, and then drop them altogether? In that case, I'm not sure we need to talk about either Backbone or jQuery, since they both aged-out a while ago?

(I would encourage us to keep the Angular.js entry for now, as a distinction from Angular, though it's probably pretty close to old enough that I could be persuaded otherwise.)

ryanhofdotgov commented 4 years ago

@mgwalker For sure – whatever you feel is best as far as what meets the threshold. Thanks!

ryanhofdotgov commented 4 years ago

@mgwalker Mind if I edit out the in-progress sections on Backbone/JQuery and merge? I think what you've up so far is valuable and want to get it published on the site.

mgwalker commented 4 years ago

Go for it!