> And certainly nobody seems to want to engage on the questions I've asked.
Fine. I'll answer them. > the comments there, to me, read as hostile to people wanting more docs. There is no "anti-more-docs" faction. Not in that thread, or this one. Nobody will obstruct you from writing docs, nor retaliate if you write docs. Nobody will be sad if you write docs. You won't see an end-of-year post for 2023, reporting that more documentation was the worst thing to happen to happen to Nim this year. Complaints about _documentation_ have ruffled nobody's feathers in that thread or this one. The thread was not locked because someone tried in it to improve documentation too hard. So, be at ease. What you saw was an illusion. > Is driving more adoption of Nim a meaningful goal? Yes. But also, much like "John Funnylastname" has heard your joke about his name ten thousand times before you said it, so also has every smaller programming community heard ten thousand times already that a random poster's pet interest is the only thing standing between their language and greater popularity. Docs, or being sufficiently nice, or having better support for this or that specific kind of program. You are the protagonist of your own story, and everything new to you feels to you like it's new also to the world -- but this comes off as lazy manipulation. You've written thousands of words in this thread about language popularity and far fewer words about any documentation improvements that you'd like to see. > If so, what are the biggest hurdles? Is there a way to overcome them? To wit. Three questions about _language popularity_. Not _documentation_. You're so pleased that someone rudely insulted the poster that offended you by not caring that much about what you had to say. Do you think that these questions should be printed on gold leaf? Is it really wrong for someone to get testy, at this point? The biggest hurdle to Nim's popularity is that more people don't write more interesting things in Nim, that other people would like to use or support. There are lots of individual reasons for that, and I'll easily accept that "bad documentation" describes some of those individual's reasons. For my part, prior bad presentation of documentation has given me the worry that nobody's taking documentation seriously, and "nobody's taking documentation seriously" is a feeling that a language doesn't have a future, which discourages my writing software in that language. The documentation presentation's gotten better; on the other hand, I find <https://nim-lang.org/> less useful because I have to scroll past a bunch of tutorials to find the manual/lib/tools references that are always what I'm going there for.
