Top
Best
New

Posted by figomore 10/22/2024

Pygfx(docs.pygfx.org)
253 points | 54 commentspage 2
indulona 10/26/2024|
pigfix
revskill 10/25/2024||
Readthedocs is such the gold standard of a library documentation, it contains the complete guide to master the concepts, besides the API.

Other languages, take a look and follow this standard, please.

prideout 10/25/2024||
Am I the only one who is irked by by ads on Read the Docs pages?
anileated 10/26/2024||
Let’s put it this way: I would consider myself eligible to be irked by ads on Read the Docs pages if I paid whoever maintains the project.

If they bother you enough, absolutely no one’s going to frown if you estimate how much they would be making on ads from traffic volume yearly, email the maintainer and suggest to pay that in return for turning off the ads for a year.

(Some people might frown if you just block the ads, since after all it is robbing a fellow open-source dev of some income.)

There are two points I am curious about:

— I would like to know if RTD forces the ads. Considering they have a business tier, it would be funny if they had to finance OSS project hosting from ads.

— EthicalAds started as an ad platform for developers, but apparently is now an “AI ad network”. I wonder if Python OSS project owners know about the 180 degree turn that’s happening there…

almarklein 10/26/2024||
I wish. The revenue from the ads goes to readthedocs, AFAIK nothing is paid to the maintainers of the project.

That said, readthedocs is a pretty nice platform to host your docs in a simple way. Plus users are not tracked. So personally I don't mind so much, but I'm going to have a look at the paid plan to remove ads for our users :)

anileated 11/2/2024||
Cheers! FWIW, I think you could easily build Sphinx docs using GHA and publish it on GitHub Pages and not pay a dime. Depending on your distaste for Microsoft’s monopoly, I suppose ;)
craigds 10/26/2024|||
We used the free tier for a couple of years before a user mentioned the ads. We had no idea our docs were surrounded by ads as no one on the team had ever tried it without ublock origin... We upgraded to the paid plan after that :)
BiteCode_dev 10/25/2024|||
Yes, because all the other people on HN use unlock origin.
littlestripes 10/26/2024|||
There are ads in docs now?? Thank my lucky adblocks
stavros 10/25/2024||
The what?
CoastalCoder 10/26/2024|
> Pygfx (pronounced “py-graphics”)

Major tangent, but am I the only one who bristles at someone telling me how to pronounce an abbreviation they invented?

I must have encountered this a few times in brand marketing within the tech world and gotten pissed off at feeling manipulated.

esperent 10/26/2024||
I can't say you're the only one, but I've certainly never bristled over this before. Or even spared it any thought. And now that I am thinking about it, I find it quite helpful actually, not bristle-worthy at all. I still have no idea how to pronounce GIF or several other acronyms that I commonly use.
ffsm8 10/26/2024|||
You're angry because the author tried to make the library searchable by removing a few letters..?

And they didn't even come up with the gfx shorthand for graphics, its admittedly an old one and barely seen nowadays... But it's always been the sister to sfx/sound effects

swiftcoder 10/26/2024|||
It's also likely a reference to the rust library underlying this whole stack (gfx-rs)
webmaven 10/26/2024|||
Alternatively, "Special Effects". Also VFX/Visual Effects, etc., one supposes.

Although that would have it expand to "Graph Effects" (hmm, that could be an interesting library), or "Graphic Effects".

But GFX expanding to simply "Graphics" has a history going back at least to the early 1990s, and even further:

https://books.google.com/books?id=Jy8EAAAAMBAJ&pg=PA35&dq=%2...

anileated 10/26/2024|||
Whether you are a user bristling at a library author telling you how to pronounce the name of the project, or library author bristling at people mispronouncing the name of the project, in OSS world we all have our things to bristle about but differ in our abilities to influence them.
gjm11 10/26/2024|||
You aren't.

I feel inclined (especially because they're trying to tell me otherwise) to pronounce it in a rather different way which I shall not make explicit here beyond saying that it splits as pyg/fx rather than as py/gfx.

swiftcoder 10/26/2024|||
I think that it is pretty important to both be prescriptive about the pronunciation of abbreviations you create, and to explain them if they are non-obvious.

Way back when I first read about nginx, I had absolutely no way to know that folks usually pronounced it "engine-X". Led to an embarrassing conversation where I and a coworker were completely at cross-purposes to one another.

Obviously there are a bunch of abbreviations with disputed pronunciations (gif/jif, SQL/sequel, etc), and since the creators weren't prescriptive about them, we're all free to argue about them for the rest of time...

wruza 10/26/2024||
Important embarrassing why? In my experience it’s only really important to insufferable people who care about their in-groupness before anything else.
swiftcoder 10/27/2024||
Important because precise communication matters in engineering. I don't mean "embarrassing" in the sense of an in-group, I mean it in the sense that misunderstandings cause engineering mixups that are trivially avoided by clear communication
nighthawk454 10/26/2024|||
I mean that seems a bit uncharitable. I don’t think the author communicating their intent behind the name is aggravating or manipulative. It’s simply an explanation. Shouldn’t be worth more than an ‘ah, I see what they’re going for’ and move on.

It’s a sign, not a cop. Doesn’t seem like any undue pressure to control people, or prevent the reader from doing what they will with.

One wonders if the IPA pronunciations on Wikipedia is similarly bristling

exe34 10/26/2024||
do you have the same reaction to people telling you how to pronounce their names or others telling you what pronouns to use?