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

Understanding Django - Portuguese #145

Open
10 of 20 tasks
nazarepiedady opened this issue Mar 12, 2023 · 12 comments
Open
10 of 20 tasks

Understanding Django - Portuguese #145

nazarepiedady opened this issue Mar 12, 2023 · 12 comments

Comments

@nazarepiedady
Copy link

nazarepiedady commented Mar 12, 2023

@mblayman I would like to contribute to translating the Understanding Django content to Portuguese (Português).
Could you help provide a clear manual about how to do this kind of contribution?

Below I list the progress of the translation, and when I finish translating all, I will do the pull request.

  • docs(pt): translate the article browser to django
  • docs(pt): translate the article urls lead the way
  • docs(pt): translate the article views on views
  • docs(pt): translate the article template-for-user-interfaces
  • docs(pt): translate the article user interaction with forms
  • docs(pt): translate the article store data with models
  • docs(pt): translate the article administer all the things
  • docs(pt): translate the article anatomy of an application
  • docs(pt): translate the article user authentication
  • docs(pt): translate the article middleware do you go?
  • docs(pt): translate the article serving static files
  • docs(pt): translate the article test your apps
  • docs(pt): translate the article deploy a site live
  • docs(pt): translate the article per-visitor data with sessions
  • docs(pt): translate the article making sense of settings
  • docs(pt): translate the article user file use
  • docs(pt): translate the article command your app
  • docs(pt): translate the article go fast with django
  • docs(pt): translate the article security and django
  • docs(pt): translate the article debugging tips and techniques
@mblayman
Copy link
Owner

I don't have a very well defined process yet as I only have a few translations for Spanish. My primary request is that you don't change the code examples. I would have a harder time validating that the code is still correct if you change that. In the Spanish version, the translator would sometimes reference a name in Spanish then mention the English name to help a reader make the logical connection.

If you're comfortable with a Pull Request, you could create a file similar to the Spanish article with the pt extension instead of es. https://github.com/mblayman/mattlayman.com/blob/master/content/understand-django/2020-01-08-browser-to-django.es.md

If you're not comfortable with PRs, you could provide a translation in some other format (like a Google Doc) and I could help get things into the right format.

You wouldn't need to worry about the Hugo setup to add Portuguese as a supported language. I can take care of that part.

If you decide to work on a translation, thank you so much!

@nazarepiedady
Copy link
Author

I will work on the translation for sure, do not worry, I am comfortable with pull request.
Thanks for your answer, I will start the work as soon as possible.

I like to do this kind of contribution as you can see below:

@nazarepiedady
Copy link
Author

@mblayman I will translate all documents and make a huge pull request with all of them.

@nazarepiedady
Copy link
Author

@mblayman could you create issues based on the task list created above?

@mblayman
Copy link
Owner

mblayman commented Jun 9, 2023

Sure, I'll create the first few.

I do look at this issue list with some regularity for personal uses, so I'm not going to create them all because I don't want to deal with GitHub pagination to see the stuff that I care about.

@nazarepiedady
Copy link
Author

@mblayman I understand since I will only do the pull request when I finish translating all
files, the issues created are good just to track a portion of the work at a time.

I already translated the first two files, and work is keep going well.

@mblayman
Copy link
Owner

mblayman commented Jun 9, 2023

@nazarepiedady I'm comfortable (and grateful) for whatever translations you provide. As a thought, have you considered putting up a pull request for 1 article at a time? If you're going in order anyway, then we could get earlier ones merged and make the Portuguese translation available to those readers as soon as the article is ready.

@nazarepiedady
Copy link
Author

@mblayman I intend to put up a pull request with all articles translated at once.
I already translated the first two articles.

@mblayman
Copy link
Owner

Since this work is opting for a mega-PR, I've closed the other issues and we can use the checklist on this issue to track.

@nazarepiedady
Copy link
Author

@mblayman, I intend to continue the translation this year, I stopped for a while because I have been with a lot of work in other projects I am in, but I am back now.

I love programming, and I want your great material available to the Portuguese-speaking community of programmers.

We are together in this project because Django is awesome.

😊

@mblayman
Copy link
Owner

@nazarepiedady, you're doing great work! I took a look at your X posts and saw that you've translated a bunch of stuff. Nice job!

@nazarepiedady
Copy link
Author

@mblayman, one more chapter added to the others already translated. This time is the user authentication chapter.

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

No branches or pull requests

2 participants