Skip to content
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

Modernise & move current (largely legacy) tutorials out of main pygame repository into their own repository #29

Open
MyreMylar opened this issue May 27, 2024 · 0 comments

Comments

@MyreMylar
Copy link
Member

The current tutorials are largely old, plus there are some translations that are not really organised. The main pygame code docs will never be translated because they change too frequently so a documentation language switcher there doesn't really work.

I think the tutorials could benefit from being pulled out entirely from the main code repository and it's documentation theming into their own thing which could have more modern support for translations (sphinx does support this).

Step 1: would just be to open a new repo with only the docs part of the tutorials in it and get them building again locally.

Step 2: would be a new proper index page of what was in the tutorials.

Step 3: would be organising the existing translations so toggling a language switcher took you to the proper translations.

Step 4: would be integrating it back into this website so the current 'tutorials' link took you to the built result of the tutorials repository rather than halfway down the docs front page. Also opening a PR to remove the (at this point duplicate) tutorials from the main pygame-ce code repository.

Step 5:* would ideally be a modernisation review/trimming of the existing text tutorials so that they were relevant and an opening up of the repository to accept PRs for things like video tutorials (if people wanted to submit them).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant