I see a lot of open source software projects that do not do a good job of describing themselves.
It's okay. There's nothing shameful about that.
Most programmers aren't writers.
Just like most writers aren't programmers.
I can't code to save my life, but I can write some killer copy and content.
Know of any open source projects that need copy written?
I want to contribute.
> Most programmers aren't writers.
I'd like to engage in a philosophical discussion about why they certainly are writers, and why good programmers must be able to write.
But I'll just thank you for your will to contribute and encourage you to do it, because it is really valuable.
@ekaitz_zarraga Well I guess literally they "write code" so they are writers. Maybe I should find a better noun or more specific adjective.
Programming languages can be studied and analysed in linguistic terms, but languages are tools not the result itself.
Are we talking about the perpetrator of #Perl? I thought you were trying to reinforce your point, not refute it. 🤷
The (random) paper that you mention talks about learning to program, it says nothing about code quality and it says nothing about #linguists either, in the sense of scientific study and analysis of languages.
Empirically speaking, that multilingual people are more adept at programming is a plausible hypothesis, though.
Not only that, Perl have been very influential and is a great language. We may or may not like it, but underestimating stuff because of our opinion instead of the technical facts or achievements just because it's kind of accepted to diss on it it's just absurd.
@alexandria @0 This pisses me off so hard.
Not because of what you @0 did, it's just a general feeling. There are projects like Perl or C++ that is kind of accepted to insult because some part of the programming community wanted to follow the trend of a couple of motherfuckers that can't shut their fucking mouth.
It's ok to dislike something, but it's not ok to throw some shit in a discussion when people is talking about facts. Let's be adults.
Not saying it's what you did here. I think you just played the easy card: let's say perl is shit, because "everybody" says that.
I was expecting something else, honestly. But you are not the one to blame.
I'm sorry, this triggered me.
I apologize if it was rude.
I didn't want to make it personal. It's just a general feeling and this conversation reminded me of it.
> The burden of successful communication is on the communicator
One begs to differ.
Communication is a shared activity. Asymmetric, yes, but it necessitates an active role from all parties.
And now to be of some actual use, projects that I think could benefit of, and deserve, better docs:
I'll add more as they come to me.
Depends what kind of docs we're talking about and, to some extent, how careful you are to write them in such a way that they stay sufficiently accurate as the system evolves.
E.g., stay away from screenshots unless you have an actual and generous budget for a doc team.
@estoricru we always enjoy contributions!
Especially with the rebranding currently going on, it can't hurt to have someone external/unbiased to have a look at the descriptions:
Let us know if you need any help :)
@estoricru In the majority of cases when I find the homepage of an unknown open source project I go to Wikipedia trying to understand what they do.
Part of the problem is also that they want their page to look nice and modern, rather than clear.
@VictorVenema Yes exactly!! I want to help solve that problem
@estoricru same here. I'd love to help with documentation & descriptions (& may I say marketing? because that's what I'll do. Marketing.)
@lexane You can say marketing. It's what I do, too.
People don't understand everyone is a marketer. We are all marketing something. Sometimes it's ourselves. Sometimes it's our ideals.
At the end of the day, we're all trying to "sell" something. The exchange may not be currency, but it's still an exchange.
I met Nick Merrill when he was passing through the Silicon Valley on a trip to try and get funding for his non-profit projects. His foundation could use some TLC in the marketing end of things. From my perspective, he earnestly means to do right by his users, and will go to court to protect their interests:
@estoricru !! I've been trying to work on the opensimulator wiki for a while, but tbh I'm not sure what a copy is (I'm not a writer! lmao)
But it certainly could use a hell of a lot of writing, and I know that I'm really bad at that !
If you want to check it out, it's http://opensimulator.org/wiki/Main_Page
I'm trying to make an improved UI for the whole thing lol
@alcinnz 100% I can help
p5js seeks a broad range of contributors
@deejoe oh hey I love p5
@estoricru Most projects can use some help ( even if it's just spreading the load )
Look at projects you use and see if there's improvement you'd like to see at the person using the software
Sometimes I just submit small grammar correction bug reports or pull requests
If you want to help with a conference, I chair the promo committee for SeaGL, we can use help with our blog posts
All my projects are in desperate need of an editor.
@paul Are they open source?
Thanks Garrett. It's a bit too soon to bring on someone in such a formal capacity, but I've saved your form link.
Several of my more recent programs are written in a style known as literate programming. Basically, I write the words describing the program structure in detail, then inject code in between the words.
At some point, it'd be really interesting to get a real writer to help tighten things up.
@estoricru everything we do basically(orca, ronin, left, dotgrid, etc).
@estoricru it's a bit complicated because to be able to efficiently write about the esoteric tool, you have to be familiar with it yourself, but then to become familiar with it we would need to have good documentation. It's a bit of a vicious circle.
@neauoire I've done technical writing before, too ;) We'll figure something out; I promise.
@neauoire Let's start w/ one project at a time tho
@estoricru Done! Most of our maintainers/contributors run their contributions through their own S-Corps or LLCs, so we’re used to such things :).
A bunch of technomancers in the fediverse. Keep it fairly clean please. This arcology is for all who wash up upon it's digital shore.