indygreg / PyOxidizer

A modern Python application packaging and distribution tool
Mozilla Public License 2.0
5.51k stars 239 forks source link

Project author sounds excessively pompous #22

Open phlummox opened 5 years ago

phlummox commented 5 years ago

The author's habit of referring to themselves as "the author", in the project documentation, makes the author sound extremely pretentious. Perhaps the author could tone it down a little.

Other than that, looks very neat. Keen to try it out.

devxpy commented 5 years ago

Yes! Also, while you're at it, why not command everyone on the planet who writes in the 3rd person to "tone it down a little"?

indygreg commented 5 years ago

@devxpy: I appreciate your willingness to get involved in PyOxidizer's development. But please don't be condescending to others who are expressing a relatively benign opinion. The original comment seemed sincere in nature and I thought it was constructive. Your response added nothing of positive value to the conversation and from my perspective was abusive towards @phlummox.

I will not tolerate repeated behavior of this kind in this project and will block people who demonstrate a pattern of disregard for civility.

phlummox commented 5 years ago

Sorry, I should have expressed myself a bit more seriously. This project seems like a great idea, as I've had many hassles trying to package up Python programs portably, and had pretty much given up on it. But - the readthedocs is often the first impression people get of a project, so I thought it might be worth flagging things that might put people off.

Looking at the project for the first time, the docco does come across as a bit ... weirdly over-formal, re the 3rd person stuff. On the one hand, I realize writing style is a matter of taste, and my taste may not suit everybody. But on the other, the readthedocs documentation is often the first impression people get of a project, and given that I'd like as many people to try this out as possible, I thought it was worth flagging any oddities.

tbh, in the FAQ section on "Why Rust?" comes across as if, on the one hand, it's trying to evangelize rust, but on the other, seem "objective" and "impersonal" by expressing it in the third person. Which I just find off-putting. Personally, I'm perfectly happy with the reason for a language being "Because this is my project, and I prefer language X. If you want to use a different language, feel free to fork".

Anyway. If it were up to me, I probably would ban writing in the third person, so no offence taken ;)

devxpy commented 5 years ago

@indygreg To be completely honest I interpreted the original post as demeaning in the first place.

You're probably right about my comment being abusive to them directly, and I should have taken the time to explain how an open source maintainer is well within their right to present their project however they seem fit. Not to mention that GitHub issues are probably not the place to express how you think someone's writing style is not in line with your own, and are IMO reserved for more important, technical discussions.

Sorry if I started a flame war. Happy to retract my comment if someone is uncomfortable.

seanjensengrey commented 5 years ago

I want to take this opportunity to give everyone a hug and preminisce about how we will look back on this and laugh when Rust+Python has achieved world domination and the author and we prevented the collapse of civilization.

phlummox commented 5 years ago

Huzzah! Hugs all round. Looking forward to the coming Py–Rust new world order. Viva la revolución!