r/javascript • • Mar 02 '18

I built Hackterms, an Urban Dictionary for coding terms, to help connect the dots while learning - and we're picking up steam! Want to help?

https://www.hackterms.com
364 Upvotes

56 comments sorted by

23

u/maxverse Mar 02 '18

Hey guys! While learning to code, I'd often fall down a rabbit hole of research for things I didn't really need. There are lots of resources that teach you how to do something, but few explain when and why. So, over the past few months, I built Hackterms - a crowdsourced dictionary of programming terms to answer these questions:

  1. at a high level, what does this tool/process/concept do? When is it used? What are the alternatives?

  2. Is this worth my time to learn now?

We're currently at 400 definitions for 350 terms, and picking up steam - just got some press! Check out the definitions, and I hope you contribute a few of your own!

TL;DR: Hackterms - simple definitions that explain when/where/why programming terms are used (but not how to use them). Built in Node/Express with Mongo, Handlebars.js and jQuery. You can learn more about how I built Hackterms on my blog

4

u/OzziePeck Mar 03 '18

Is the code open source?

2

u/Cedricium JavaScript makes me go :snoo_putback: :table_flip: Mar 03 '18

From an earlier response:

I'm using Node/Express with Mongo, and handlebars/jQuery on the front end. The project isn't officially open-source (although, of course, the content is all community-generated), but the code is on github.

1

u/OzziePeck Mar 03 '18

Should’ve read the comments. This is a neat project. Something I can contribute to for once. Also a very useful website too.

0

u/[deleted] Mar 03 '18

[deleted]

3

u/OzziePeck Mar 03 '18

Features, bugs patched. Performance improvements.. I mean it’d be nice.

4

u/BoredPudding Mar 03 '18

Nah, for a company it would be hell. Features is suddenly something they can't easily decide on, because somebody would just program it anyway and submit a pull request. Then they end up with an angry user when it's rejected.

Instead of focussing on their project, they suddenly have a community they need to manage as well.

Open source makes sense for a lot of things, but not for products owned/created by one company.

2

u/yorickpeterse Mar 04 '18

Open source works pretty well for GitLab (the libre/CE edition at least).

1

u/BoredPudding Mar 04 '18

But GitLab is a product which can be useful on-site, and the customers are all separate from each other.

Hackterms on the other hand is one website. You don't want random websites popping up with the same idea.

1

u/pittsblake Mar 13 '18

Do you have your ERD for this posted somewhere?

1

u/maxverse Mar 13 '18

Not yet, but I do have two thoughts!

  1. I didn't know what an ERD was - you should add the definition :)

  2. A map like this would be awesome - I'm going to look into how these are made.

0

u/[deleted] Mar 05 '18

[deleted]

1

u/maxverse Mar 05 '18

Thanks so much! Glad it's really helpful :) No API yet, but there have been a few requests, so I'm definitely considering it.

13

u/[deleted] Mar 02 '18

This is a great idea. When I was new I spent way too much time googling nebulous, hard to find terms. Good on you, sir or madam.

3

u/maxverse Mar 02 '18

Thank you! I struggled with this, and I'm glad it helps others, too :)

3

u/itijara Mar 03 '18

Defining some of these terms is hard. I ended up doing lots of Yak Shaving, that is backtracking to solve problems necessary to solve the initial problem, while defining some terms.

4

u/maxverse Mar 03 '18

That's funny - I defined Yak Shaving after it kept coming up in searches!

2

u/OmegaVesko Mar 02 '18

You seem to have a bug that causes the last character of a linked term to be duplicated. https://i.imgur.com/Hs9VvZq.png

2

u/maxverse Mar 02 '18

Beta feature (automatic linking) that's clearly not fully baked - just turned it off! Thank you for catching this

11

u/its_never_lupus Mar 02 '18

Did you know it' been done before?

http://hackersdictionary.com/html/The-Jargon-Lexicon-framed.html

(it may be out of date, and was assembled by a couple of editors rather than modern croudsourcing)

2

u/hallettj Mar 02 '18

I was thinking about this also. But I think that a crowd-sourced repository that can be kept up-to-date is useful.

7

u/stevedorries Mar 03 '18

What’s wrong with the jargon file?

1

u/NotSelfAware Mar 02 '18

Is it open source? What stack are you using?

5

u/maxverse Mar 02 '18

I'm using Node/Express with Mongo, and handlebars/jQuery on the front end. The project isn't officially open-source (although, of course, the content is all community-generated), but the code is on github.

2

u/ShlimDiggity Mar 02 '18

Your site is currently offline (JIC you didn't know!)

1

u/maxverse Mar 02 '18

So sorry about that! We're now back up and running smoothly.

1

u/ShlimDiggity Mar 02 '18

No worries at all, just wanted you to know. Thanks

-1

u/akujinhikari Mar 02 '18 edited Mar 03 '18

Had me until Handlebars/jQuery

Can we please stop using jQuery?

EDIT: Pretty typical that people just down vote. Please explain why we still use jQuery.

3

u/Pringelman Mar 03 '18 edited Mar 03 '18

Open a PR that refactors it to use react/angular/Vue/whatever.

Edit: I only read now that it's not open source. There's nothing wrong with using jQuery to build a front-end. I personally wouldn't, but questioning someone elses technology choice is not productive and/or helpful feedback for them. Rather try out the platform itself and perhaps offer some constructive input that will help the OP improve his or her service.

1

u/akujinhikari Mar 03 '18

My constructive input is to stop using jQuery. Yes, there is something wrong with using it: it’s an unnecessary library. Prior to ES6 and less-compliant browsers, yes, jQuery was amazing. But now it’s pointless. The only reason people still use jQuery is because their favorite library is written in jQuery and other jQuery fan boys keep writing shit in jQuery. Let’s push the web forward and stop clinging to the God damned jQuery.

1

u/hahanawmsayin Mar 03 '18

jQuery is the perfect way to start learning about DOM manipulation and making something "cool" when you're just getting started.

4

u/akujinhikari Mar 03 '18

No it isn’t. The perfect way is to use vanilla js and css transitions. Loading a 200kb library simply to write $(‘#myDiv’) instead of document.querySelector(‘#myDiv’) is stupid and bad practice. New developers are learning they don’t have to learn: just pull in another library!

1

u/stevedorries Mar 04 '18

Back buttons don’t work as expected on iOS Chrome.

1

u/maxverse Mar 04 '18

Thank you for responding! Could you elaborate?

1

u/Kawaiieg Mar 02 '18

I clicked on 'random' and got 'Internal Server Error' - in a way, not disappointed

1

u/soup-zilla Mar 03 '18

Some terms might benefit from very simple definitions that are labeled "ELI5" for non/less technical users who land on the site.

1

u/StoneColdJane Mar 03 '18

i just added one >)

1

u/verde622 Mar 03 '18

Just a heads up, there is a little typo in the <title>

1

u/ricchh Mar 03 '18

Does it support syntax highlighting?

0

u/[deleted] Mar 02 '18

[deleted]

3

u/maxverse Mar 02 '18

Thank you! I might actually take you up on that. I love UX, but UI/graphic design is definitely my weakest point.

4

u/Washbucketlove Mar 02 '18

Great work! Personally, I would like to see a "Next" button to sift through the definitions. Also like /u/wesleyshynes idea of flash cards.

Thanks for sharing!

2

u/maxverse Mar 02 '18

Shoot me a note at [email protected] if you have any specific ideas!

1

u/[deleted] Mar 03 '18

You should censor that email, otherwise you'll get lots of spam bots.

1

u/maxverse Mar 03 '18

Could you explain?

2

u/techmighty Mar 03 '18

s p a m m a i l s son!

1

u/BoredPudding Mar 03 '18

You'll get a lot of spam bots anyway. There is no way to keep your email secret forever. Best protection is a spam filter.

1

u/[deleted] Mar 03 '18

Wrong. Best protection is a catch-all email. I have one email address for every account I have. So, if one of those emails leaks, I can know who messed up and then block that email forever.

1

u/SlocketRoth Mar 03 '18

seems a bit excessive no?

1

u/[deleted] Mar 03 '18

Why? It's pretty easy and it's the only reliable way to have a spam free mail account.

1

u/SlocketRoth Mar 03 '18

its it not a bitch to have to manage all the different accounts?

1

u/[deleted] Mar 03 '18

It's one account, I have a catch all mail on my own domain. There's no need to create them, they basically already exist, so even [email protected] would arrive without any issues.

2

u/SlocketRoth Mar 03 '18

oh cool, so when you sign up to say reddit, you do it as [email protected], but [email protected] is only used with trusted sources and if reddit ever does send you spam, you'll never see it because its sent to the catch all?

→ More replies (0)

4

u/[deleted] Mar 02 '18

[removed] — view removed comment

2

u/maxverse Mar 02 '18

Great idea! Tell me more about what that'd look like?

1

u/Omnicrola Mar 03 '18

Not my idea, but what I envisioned when I saw that was the ability for each user to curate a "deck". (Probably more than one) Let others vote on them if they find them useful.

This would allow the creation of both personal decks of things you want to learn, and widely used curated decks for those beginning new journeys into a specific language, methodology, tool, or just programming in general.

After selecting a set of terms and saving them, you can "play". The site displays each term from the deck in random order. The user clicks either, "I remember" or "I forgot". Either way, the definition is then shown. After all cards are shown, an option to replay the ones marked as forgotten is presented. After that, a final result is displayed with the percentage or count that the user remembered. Maybe also with a total time.

I don't think scores should be saved or publicly displayed, as the objective is learning not competition/widget acquisition. Also if a deck is edited after a user completed it, it would render the record/reward relatively meaningless anyway.