Asklemmy

44824 readers

1184 users here now

A loosely moderated place to ask open-ended questions

Search asklemmy 🔍

If your post meets the following criteria, it's welcome here!

Open-ended question
Not offensive: at this point, we do not have the bandwidth to moderate overtly political discussions. Assume best intent and be excellent to each other.
Not regarding using or support for Lemmy: context, see the list of support communities and tools for finding communities below
Not ad nauseam inducing: please make sure it is a question that would be new to most members
An actual topic of discussion

Looking for support?

Looking for a community?

Lemmyverse: community search
sub.rehab: maps old subreddits to fediverse options, marks official as such
[email protected]: a community for finding communities

~Icon~ ~by~ ~@Double_[email protected]~

founded 5 years ago

MODERATORS

[email protected]

now i can feel devs pain from no documentation-reading people, anyone here had a similar experience? (lemmy.ml)

submitted 3 years ago by [email protected] to c/[email protected]

4 comments fedilink hide all child comments

so recently i've been working on a project and a girl joined me, so i sent her my documentation for support, which describes EVERY single thing on this project, but every single time she asks me something that is already answered on the documentation. Probably she thinks that long text it's there just as decoration. Man, sometimes i'm so ashamed from thinking on the wrong head.

Does anyone here relates to this? I don't want to suffer this frustration alone

top 4 comments

sorted by: hot top controversial new old

[–] [email protected] 7 points 3 years ago (2 children)

Documentation is hard to get right, and something than is often taught wrong and with the wrong goal. It's not amount or "coverage" that matters, it's making it available exactly where it's needed.

It's like comments: Comments are not intrinsically good, they are a necessary evil (Uncle Bob).

[–] [email protected] 3 points 3 years ago

oh btw i have visited your profile and read your comments, you're really smart. Great arguments and nice talking, congratulations. I am glad there's still people who knows how to talk properly.

[–] [email protected] 2 points 3 years ago (1 children)

yeah, and that's exactly what my documentation is about, it isn't even long, covering the most important questions, looks like more a bunch of instructions than a formal documentation

[–] [email protected] 2 points 3 years ago

Well, reading documentation is a skill people need to acquire as well, hopefully your documentation will help her learn this skill soon :)

Oh, and thanks for the kind words!