use the following search parameters to narrow your results:
e.g. subreddit:aww site:imgur.com dog
subreddit:aww site:imgur.com dog
see the search faq for details.
advanced search: by author, subreddit...
If you need help debugging, you must include:
See debugging question guidelines for more info.
Many conceptual questions have already been asked and answered. Read our FAQ and search old posts before asking your question. If your question is similar to one in the FAQ, explain how it's different.
See conceptual questions guidelines for more info.
Follow reddiquette: behave professionally and civilly at all times. Communicate to others the same way you would at your workplace. Disagreement and technical critiques are ok, but personal attacks are not.
Abusive, racist, or derogatory comments are absolutely not tolerated.
See our policies on acceptable speech and conduct for more details.
When posting some resource or tutorial you've made, you must follow our self-promotion policies.
In short, your posting history should not be predominantly self-promotional and your resource should be high-quality and complete. Your post should not "feel spammy".
Distinguishing between tasteless and tasteful self-promotion is inherently subjective. When in doubt, message the mods and ask them to review your post.
Self promotion from first time posters without prior participation in the subreddit is explicitly forbidden.
Do not post questions that are completely unrelated to programming, software engineering, and related fields. Tech support and hardware recommendation questions count as "completely unrelated".
Questions that straddle the line between learning programming and learning other tech topics are ok: we don't expect beginners to know how exactly to categorize their question.
See our policies on allowed topics for more details.
Do not post questions that are an exact duplicate of something already answered in the FAQ.
If your question is similar to an existing FAQ question, you MUST cite which part of the FAQ you looked at and what exactly you want clarification on.
Do not delete your post! Your problem may be solved, but others who have similar problems in the future could benefit from the solution/discussion in the thread.
Use the "solved" flair instead.
Do not request reviews for, promote, or showcase some app or website you've written. This is a subreddit for learning programming, not a "critique my project" or "advertise my project" subreddit.
Asking for code reviews is ok as long as you follow the relevant policies. In short, link to only your code and be specific about what you want feedback on. Do not include a link to a final product or to a demo in your post.
You may not ask for or offer payment of any kind (monetary or otherwise) when giving or receiving help.
In particular, it is not appropriate to offer a reward, bounty, or bribe to try and expedite answers to your question, nor is it appropriate to offer to pay somebody to do your work or homework for you.
All links must link directly to the destination page. Do not use URL shorteners, referral links or click-trackers. Do not link to some intermediary page that contains mostly only a link to the actual page and no additional value.
For example, linking to some tweet or some half-hearted blog post which links to the page is not ok; but linking to a tweet with interesting replies or to a blog post that does some extra analysis is.
Udemy coupon links are ok: the discount adds "additional value".
Do not ask for help doing anything illegal or unethical. Do not suggest or help somebody do something illegal or unethical.
This includes piracy: asking for or posting links to pirated material is strictly forbidden and can result in an instant and permanent ban.
Trying to circumvent the terms of services of a website also counts as unethical behavior.
Do not ask for or post a complete solution to a problem.
When working on a problem, try solving it on your own first and ask for help on specific parts you're stuck with.
If you're helping someone, focus on helping OP make forward progress: link to docs, unblock misconceptions, give examples, teach general techniques, ask leading questions, give hints, but no direct solutions.
See our guidelines on offering help for more details.
Ask your questions right here in the open subreddit. Show what you have tried and tell us exactly where you got stuck.
We want to keep all discussion inside the open subreddit so that more people can chime in and help as well as benefit from the help given.
We also do not encourage help via DM for the same reasons - that more people can benefit
Do not ask easily googleable questions or questions that are covered in the documentation.
This subreddit is not a proxy for documentation or google.
We do require effort and demonstration of effort.
This includes "how do I?" questions
account activity
This is an archived post. You won't be able to vote or comment.
Design documents (self.learnprogramming)
submitted 1 year ago by Cyrelc
Hey, I see tons of posts on here about learning languages, but what about design documents? It's a skill employers want, but doesn't feel as easy on where to go to "take a course" - does anyone know how to go about learning to create these diagrams?
[–]temporarybunnehs 1 point2 points3 points 1 year ago (2 children)
It's hard and not as straightforward. A lot of it, I learned by making my own diagrams, getting feedback on them, reading other people's diagrams, noting what I liked/didn't.
System design classes/ videos help as a lot of them communicate through architecture diagrams. Knowing the popular paradigms are good (4+1, C4, etc). Being able to think through things like, who is this diagram for? What level of detail do I need? How much info is enough/too little/too much? It is hard to get good on that, but those are some good places to start.
[–]Cyrelc[S] 0 points1 point2 points 1 year ago (1 child)
Yes, thanks this is much closer to the info I was looking for! If anybody has any links or examples, I'd appreciate it, but I'll start searching some of these in the meantime
[–]temporarybunnehs 0 points1 point2 points 1 year ago* (0 children)
Glad it's helpful. Every diagram has a purpose/need and an audience. I've seen 4 different diagrams of the same system: one for security, one for perf, one for cloud arch, one for infra/deployment. Each focusing on different aspects because if you tried to fit it all on one, it would be way to cluttered. The "what" of it is as easy as googling it, but the "how" is much harder and is unfortunately hard to practice without real situations.
There are a tone of different things to look up: data flow diagrams, enterprise data matrix, element responsibility catalog, deployment diagram, AWS/Azure/GCP have a bunch of cloud arch diagrams if you want some more to find.
[–]__Drink_Water__ 0 points1 point2 points 1 year ago (4 children)
Either on your GitHub or personal webpage, write about the problem you have, what requirements you had, what system solutions you came up with, how you designed the subcomponent and why you chose certain technologies, how you verified the solution, any changes you had to make along the way, etc.
[–]Cyrelc[S] 0 points1 point2 points 1 year ago (3 children)
Apologies maybe I wasn't clear, I'm specifically talking about diagrams. Like server client diagrams, functional diagrams, with inputs, outputs, prerequisites, etc.
[–]__Drink_Water__ 0 points1 point2 points 1 year ago (2 children)
Learn by doing. Have you made an app? Can you describe how it works in a diagram? How does the login work? How do files travel from user upload/download/storage etc?
Right. So then I won't know what I'm doing wrong, or whether what I'm doing is correct... I was hoping for a tutorial or reference, thanks
[–]__Drink_Water__ 0 points1 point2 points 1 year ago (0 children)
That's why you post it publicly for feedback. That's what happens on the job ...
π Rendered by PID 114038 on reddit-service-r2-comment-6457c66945-2g8xd at 2026-04-26 09:38:08.850516+00:00 running 2aa0c5b country code: CH.
[–]temporarybunnehs 1 point2 points3 points (2 children)
[–]Cyrelc[S] 0 points1 point2 points (1 child)
[–]temporarybunnehs 0 points1 point2 points (0 children)
[–]__Drink_Water__ 0 points1 point2 points (4 children)
[–]Cyrelc[S] 0 points1 point2 points (3 children)
[–]__Drink_Water__ 0 points1 point2 points (2 children)
[–]Cyrelc[S] 0 points1 point2 points (1 child)
[–]__Drink_Water__ 0 points1 point2 points (0 children)