-
-
Notifications
You must be signed in to change notification settings - Fork 138
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Move tutorials out of main repo into their own repository #2878
Comments
As a guy who has bugged you about this in private DMs:
|
Yes, much better! |
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'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 |
Looking at the crude webpage I made almost a year ago makes me uneasy.. lol |
It would be good. |
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:
The text was updated successfully, but these errors were encountered: