Open MyreMylar opened 1 month ago
robertpfeiffer
commented
1 month ago As a guy who has bugged you about this in private DMs:
Gabryel-lima
commented
1 month ago There has been some debate recently about slimming down the main repository into some smaller packages for various reasons. One area I think that could really benefit from this is the existing tutorials section of the docs.
We have some fairly old text based tutorials, mixed with a few more recent ones bundled awkwardly in our docs. We also have a couple of these tutorials translated into different languages and one current PR with another set of translations. The main docs have no way of cleanly switching the language, and never will because it would be impossible for a project with our resources to keep code documentation up to date with changes in multiple languages.
However, a separate tutorials repository with it's own sphinx build could do this:
This repository could also potentially guide the modernising of the tutorials into the video era of the web (there was no such thing as youtube when many of the pygame tutorials were first written).
I added an issue on this topic to the website repository too as that's where the output from the proposed new tutorials repository would be hosted under the current 'tutorials' link from the main page:
Yes, much better!
Starbuck5
commented
1 month ago I'm skeptical of the benefit of moving them out into a separate repository.
If we have outdated tutorials rotting in the main repository, moving them into another repository just lets them rot in a different place? A place that's even less likely to have eyes on it?
RE examples, anybody can post examples on Github, there have been several projects. Like https://github.com/pygame-examples/pygame-examples
novialriptide
commented
1 month ago I'd say that we should make every example that's been well thought-out like aliens.py to be in their own separate repository such as https://github.com/pygame-community/pygame-aliens.git and remove smaller examples such as go_over_there.py
If we would like to take from example...
Monogame has separate repositories for their examples:
As well as Godot Engine:
As well as raylib:
But not heaps.io, the game engine powering Dead Cells
novialriptide
commented
1 month ago Looking at the crude webpage I made almost a year ago makes me uneasy.. lol
Gabryel-lima
commented
3 weeks ago I'd say that we should make every example that's been well thought-out like aliens.py to be in their own separate repository such as https://github.com/pygame-community/pygame-aliens.git and remove smaller examples such as go_over_there.py
If we would like to take from example...
Monogame has separate repositories for their examples:
As well as Godot Engine:
As well as raylib:
But not heaps.io, the game engine powering Dead Cells
It would be good.
Gabryel-lima
commented
3 weeks ago I'm skeptical of the benefit of moving them out into a separate repository.
If we have outdated tutorials rotting in the main repository, moving them into another repository just lets them rot in a different place? A place that's even less likely to have eyes on it?
RE examples, anybody can post examples on Github, there have been several projects. Like https://github.com/pygame-examples/pygame-examples
I've been here for a while and haven't noticed this repo yet lol
Starbuck5
commented
3 weeks ago I've been here for a while and haven't noticed this repo yet lol
So you're saying that we should move things out of the main repo and that you don't notice other repos?
My point is that people can post their examples on the internet without it being an official part of our repo or our Github organization, and there's nothing wrong with that.
Gabryel-lima
commented
3 weeks ago I've been here for a while and haven't noticed this repo yet lol
So you're saying that we should move things out of the main repo and that you don't notice other repos?
My point is that people can post their examples on the internet without it being an official part of our repo or our Github organization, and there's nothing wrong with that.
That's not what I meant. I just pointed out that I hadn't seen the example repo here
There has been some debate recently about slimming down the main repository into some smaller packages for various reasons. One area I think that could really benefit from this is the existing tutorials section of the docs.
We have some fairly old text based tutorials, mixed with a few more recent ones bundled awkwardly in our docs. We also have a couple of these tutorials translated into different languages and one current PR with another set of translations. The main docs have no way of cleanly switching the language, and never will because it would be impossible for a project with our resources to keep code documentation up to date with changes in multiple languages.
However, a separate tutorials repository with it's own sphinx build could do this:
This repository could also potentially guide the modernising of the tutorials into the video era of the web (there was no such thing as youtube when many of the pygame tutorials were first written).
I added an issue on this topic to the website repository too as that's where the output from the proposed new tutorials repository would be hosted under the current 'tutorials' link from the main page: