Readit News logoReadit News
Posted by u/cristianMD7 2 years ago
Codictionary: A newsletter that explain tech terms in plain, everyday languagecodictionary.com/...
Hey there! As a software developer, I've always wished that my clients, managers, directors, and stakeholders could get a better grasp of programming. I know they can't become coding gurus overnight, but wouldn't it be awesome if they could at least understand terms like APIs, caching, and variables? I think it would make communication a whole lot smoother and help us have more meaningful conversations. I decided to create a newsletter that explains all these tech terms in super simple language!

At first, I tried to make a newsletter just for my clients. I wanted to bridge the gap between tech-savvy folks like me and those who aren't as familiar with the ins and outs of programming. But then it hit me—why not make it available to everyone who wants to understand the tech world without having to learn how to code? So, I revamped it to cater to anyone who's curious about technology.

Each edition of the newsletter focuses on a specific tech term or concept. We'll break it down, ditch the complicated jargon, and give you real-life examples that make it all crystal clear. My goal isn't to teach you programming (that's a whole different ball game). Instead, I want to give you the knowledge you need to have better conversations and a deeper understanding of the tech that shapes our world.

So, whether you're an entrepreneur who wants to connect better with your tech team, a project manager looking to understand what the developers are talking about, or simply a tech enthusiast who wants to dive into the digital world, hop on board and let's make tech simple together!

smarkov · 2 years ago
$12/month for a ELI5 seems pretty steep to me, especially so during these times when ChatGPT is available (even with its caveats).

Targeting developers who are just starting out is a cute concept but having to decipher the ramblings of a madman, be it in code or documentation, is a pretty standard part of the job.

cristianMD7 · 2 years ago
I completely agree with you on the importance of developers being able to read and understand others' code and documentation. It's an essential part of their job. However, the focus of my newsletter is a bit different. It caters to a specific audience: managers and directors, who may not need to learn programming but need to at least understand what a server is for example.
smarkov · 2 years ago
What's the intended way it's supposed to be used? Are the managers and directors supposed to subscribe to it or the developers? If it's the developers, when they need to explain a concept do they just copy-paste the explanations? Forward an email? Send some kind of a link? It seems like an awkward interaction to me.

As a developer, it's always been my job to explain things to non-technical people in as few words as possible during conversations. I'm not sure how a newsletter would fit in that use case.

personjerry · 2 years ago
It's interesting you show a picture of Wikipedia but then don't mention the Simple English wikipedia, i.e. https://simple.wikipedia.org/wiki/Application_programming_in...

What differentiates your product from the Simple English wikipedia for example?

cristianMD7 · 2 years ago
Thanks for the question, it's a good one.

Unlike the Simple English Wikipedia, which covers a bunch of topics in a traditional encyclopedia format, we're laser-focused on tech. We dive deep into tech terms, giving you concise explanations that cut through the noise. We're all about keeping it relevant, practical, and accessible to everyone. But the best part is that we're not just sending you information and leaving you hanging. If something isn't clear or you have questions, just hit that reply button in our email. We're here to chat and give you personalized explanations.

eagleinparadise · 2 years ago
I am also a non-technical person learning to code with GPT as my mentor.

If non-techie people are willing to pay you $15 for you to write simplified summaries of programming concepts, so they can glance for 15 seconds at the occasional email they receive, then good on you. I can actually see people paying, but let's be real... ChatGPT can do this.

Your value add is that you're just giving a 'path' for someone to follow along since they won't know where to start. But anyone that 'wants' to learn will quickly find a learning path like javascript.info

cristianMD7 · 2 years ago
You're absolutely right, ChatGPT can do this if someone has the curiosity and motivation to ask it for explanations. However, in my experience working with my clients, I haven't seen them utilize it in this way. Just a couple of months ago, when I discussed optimizing the application and mentioned APIs, they had no understanding of how they work. Even if I were to ask them today, I doubt they would have much knowledge on the subject. Would they read a well-formatted email, that they paid to get, to understand what's an API and how it works? I hope yes and I should find out with this project.
DANmode · 2 years ago
You're overestimating people's abilities to teach themselves.

The amount of individuals I've come across who don't even have instinct to look up vocabulary they don't know is unbelievable.

capableweb · 2 years ago
Happens all the time, even users on HN sometimes ask very basic questions that could be answered by just looking up a word in a dictionary, or doing a very quick search for more information.

> [...] It's more of a LARP where we pretend we have some [...]

> What's a LARP?

> https://news.ycombinator.com/item?id=36104515

spdustin · 2 years ago
Never underestimate the capacity of people to not bother hitting ChatGPT to explain things to them. We all might have it set as a default in our heads, but I can see this newsletter appealing to lots of managers. The same folks who have word-a-day calendars (or tweet alerts for them) would certainly go for this, imho.
memset · 2 years ago
Congratulations on launching! I’ve often found myself doing these kinds of explanations as an eng manager to other stakeholders, so kudos for identifying a problem and launching a solution.

Lots of folks here with commentary on pricing and chatgpt. I’ll suggest that these folks aren’t your customers - they already know what an API is! From a business perspective the most valuable feedback will be from people who have a need, right now, to get up to speed on technical topics. Take HN with a little grain of salt.

Good luck!

cristianMD7 · 2 years ago
Thanks a million for the encouragement! I really appreciate your uplifting words.
acodingcow · 2 years ago
I feel like this type of task was already handled well by ChatGPT. I am a designer currently learning web development. When I am confused about something, I just add a prompt such as "explain it to a middle school student" to the question.

For example,

Q: "What is closure in javascript?"

GPT4.0: A closure in JavaScript is a function that has access to its own scope, the scope of the outer function, and the global scope. This feature enables the function to access variables from an enclosing scope even after that scope has finished execution, providing a sort of "memory" for the function.

Q: "What is closure in javascript? Your task is to explain it to a middle school student."

GPT4.0: "Imagine you're building a magical castle. Inside this castle, you have a special room where you keep all your secret treasures. Normally, once you leave the room, you can't see or use the treasures anymore.

But then, you invent a magical backpack. With this backpack, you can take any treasure from the room, and no matter where you go, you can always see and use the treasure you put into the backpack. Even if the room disappears, the treasures in your backpack stay with you.

In JavaScript land, the "castle" is like your program, the "room" is a function, and the "treasures" are variables or data that the function uses. A closure is like the magical backpack. It's a special kind of function that remembers the variables it saw when it was created, even after the function it was created inside is done running."

memset · 2 years ago
I’ll say that this example doesn’t convince me that chatgpt is a substitute. I find it downright confusing.

We start off with “imagine a magic castle”, then a magical backpack that lets you put things in and take them out in a different location - doesn’t a regular backpack do this already? and a (magical?) room that disappears. None of this makes any sense, it doesn’t relate any of these concepts to something a student might already know about.

I don’t doubt that gpt will continue to improve, but this example makes me feel like the OP will definitely be able to add value for explaining concepts.

hutzlibu · 2 years ago
Smart prompt and yes, ChatGPT is very useful for learning, no doubt. Especially for javascript since it is so widespread and so many learning ressources incorporated. So mostly things should be fine. (for more exotic languages, it isn't)

But you still have to check with proper ressources and if possible, a real human at the current state of tech. Otherwise you will likely get some things very wrong and that can hurt you later.

cristianMD7 · 2 years ago
Congrats on learning web development! ChatGPT can indeed be super helpful when learning programming, I wish I had access to such a tool back in my days when I was learning it. A lot of people I'm working with are not using it in such a form, and maybe my newsletter can help them learn some of those terms.
the-printer · 2 years ago
I would be more interested in a newsletter that offers comprehensive bits of information on useful tech topics (or any topic for that matter) if it was from a source with reputable knowledge in the domain who was providing it in a fashion derived from their subjective expertise.

The personification of businesses + the personification of AI in this instance frustrates me since it’s clear to myself and most users on HN and possibly not so clear to others, that it’s likely that the “We” who is explaining the projects is not necessarily the “you”, as in the person advertising this service or any other human being that you work with.

cristianMD7 · 2 years ago
I appreciate your feedback. There are some really great writers on Substack that provide tech topics from their subjective expertise, and as you, I'm also interested in that. This newsletter is trying to achieve a different goal.
andrewem · 2 years ago
A suggestion on your sample. It says “The librarian goes to the stacks, finds the book, and brings it back to you.

The next time you need that same book, the librarian doesn't have to go all the way to the stacks again – they can just grab it from the shelf behind the counter.”

This is missing the step where after you return the book to the librarian, they put it on the shelf behind the counter.

Then if you want you can talk about the shelf only fitting a limited number of books, and the librarian having to decide what to do if the shelf is full.

cristianMD7 · 2 years ago
This is very good suggestion, thanks. I'm in the process of rewriting some sections of the sample and will update the 'librarian' part.
gist · 2 years ago
In the example you use (cristianmd7 OP) you should put a large X or make it clear the wikipedia example is the villain. Also put your example (what you write) in a larger color.

I would also include an about page with a writeup of your qualifications to be doing this (as specific as you want to get w/o personal info if you don't want it there).

Finally I'd also offer a service that is not a newsletter basically an 'ask me' type where a non tech person can email questions and get short replies.

cristianMD7 · 2 years ago
Thanks for the suggestions! I really like the idea of adding an 'ask me' feature, and I'll definitely think about how to implement it. Right now, I'm working on creating an About Us page to share more about the team behind this project. I agree that the design could be improved, but I wanted to launch something quickly to validate the idea.

Once again, I appreciate your advice. It's really helpful, and I'll take it into consideration as I continue to develop and make enhancements.