Make Transifex_Setup.md and the glossary intro plainer

Author: BHUVANSH855

GLOSSARY.md

@@ -1,11 +1,11 @@
 # Punjabi (pa) Python Docs Glossary
 
-Preferred Punjabi terms for translating the Python documentation. Use them so translations stay consistent. For writing style, see `STYLE_GUIDE.md`.
+These are the Punjabi terms we use when translating the Python documentation, so that the translation stays consistent. For how we write, see `STYLE_GUIDE.md`.
 
 # How to Use This Glossary
 
-- Use the listed term whenever one exists. Do not introduce variants.
-- For a term that is not listed, reuse the wording from existing translations. If there is none, use one wording consistently in the file and propose it as described under "Adding or Changing a Term".
+- If a term is listed here, use it. Don't use a variant.
+- If it isn't listed, reuse the wording from existing translations. If there is none, follow the steps under "Technical terms" in `STYLE_GUIDE.md` and propose the term as described under "Adding or Changing a Term" below.
 - Never translate function, module, class and exception names, directives, roles, placeholders or code.
 
 ---

Transifex_Setup.md

@@ -1,67 +1,63 @@
 # Transifex Guide
 
-This guide helps new translators get started in Transifex. Translating and reviewing happen there, so you do not need Git, a fork or a pull request.
+This page shows new translators how to start in Transifex. You do all the work there, so you don't need Git, a fork or a pull request.
 
 ## Join the project
 
 1. Create a Transifex account, or sign in, at <https://app.transifex.com/>.
-2. Open the [Python Documentation project](https://explore.transifex.com/python-doc/python-newest/) and press "Join this project".
-3. Choose Punjabi (`pa`) and wait for a coordinator to approve you. The coordinators are listed in the [README](README.en.md).
-4. Ask a coordinator which resource to start with, so that two people do not work on the same one. A resource is one documentation file, for example `library-fileinput`.
+2. Open the [Python Documentation project](https://explore.transifex.com/python-doc/python-newest/) and click "Join this project".
+3. Choose Punjabi (`pa`). A coordinator will approve your request. The coordinators are listed in the [README](README.en.md).
+4. Ask a coordinator which resource to start with, so that two people don't work on the same one. A resource is one documentation file, for example `library-fileinput`.
 
-If you cannot see Punjabi or your resource, ask a coordinator. Please do not create another project, language or resource.
+If you can't see Punjabi or your resource, ask a coordinator. Please don't create another project, language or resource.
 
 ## Translate
 
 1. Open the project, choose Punjabi (`pa`) and open your resource in the editor.
-2. Use the **Untranslated** filter to see the strings that still need translation.
-3. Click a string. The editor shows the English source and a field for your Punjabi translation.
-4. Press **Save**. Typing alone does not save the translation. Then go to the next string.
+2. Use the **Untranslated** filter to see what still needs translating.
+3. Click a string. The editor shows the English text and a field for your Punjabi translation.
+4. Click **Save**. Typing alone doesn't save it. Then move on to the next string.
 
 ```text
 Source:      Input and Output
 Translation: ਇਨਪੁੱਟ ਅਤੇ ਆਉਟਪੁੱਟ
 ```
 
-## Keep code and markup
+## Code and markup
 
-Python documentation contains code and Sphinx markup, such as `print()`, `os.path`, `:func:`, `{name}`, `%s` and `.. code-block:: python`. Do not translate or change them. Translate only the text around them.
+The documentation contains code and Sphinx markup, like `print()`, `os.path`, `:func:`, `{name}`, `%s` and `.. code-block:: python`. Leave these as they are and translate only the text around them.
 
 ```text
 Source:      It uses the :func:`print` function.
 Translation: ਇਹ :func:`print` ਫੰਕਸ਼ਨ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ।
 ```
 
-The details are in [RULES.md](RULES.md). Before translating a technical term, check [GLOSSARY.md](GLOSSARY.md). If the term is not there, follow the order in [STYLE_GUIDE.md](STYLE_GUIDE.md), and ask a coordinator if you are unsure. We want clear, natural, technically accurate Punjabi, not a word-for-word copy.
+[RULES.md](RULES.md) has the details. Before you translate a technical term, look it up in [GLOSSARY.md](GLOSSARY.md). If it isn't there, follow the steps in [STYLE_GUIDE.md](STYLE_GUIDE.md), and ask a coordinator if you're still unsure. We want Punjabi that is clear and correct, not a word-for-word copy.
 
-## Warnings and errors
+## Warnings
 
-Transifex checks a translation when you save it, for example for missing placeholders or changed markup. Read the message and fix the translation before saving again. If you do not understand it, ask a coordinator.
+Transifex checks a translation when you save it, for example for missing placeholders or changed markup. Read the message and fix the translation before you save it again. If you don't understand the message, ask a coordinator.
 
 ## When you finish a resource
 
-- All strings are translated and saved.
-- Code, placeholders and markup are unchanged.
-- You followed the glossary and the style guide.
+Make sure that all strings are translated and saved, that code, placeholders and markup are unchanged, and that you followed the glossary and the style guide. Then tell a coordinator. A reviewer will approve your translations. Don't mark them as reviewed yourself unless you have reviewer permission.
 
-Then tell a coordinator. A reviewer approves the translations. Please do not mark translations as reviewed yourself unless you have been given reviewer permission.
+## Reviewing
 
-## Review
-
-Reviewers use the **Unreviewed** filter, check each string against the review points in [STYLE_GUIDE.md](STYLE_GUIDE.md), and mark it as reviewed. Ask a coordinator for reviewer permission.
+Reviewers use the **Unreviewed** filter, check each string against the [review checklist](STYLE_GUIDE.md#review) and mark it as reviewed. Ask a coordinator for reviewer permission.
 
 ## What happens next
 
-Reviewed translations are pulled into this repository every day and published at <https://docs.python.org/pa/>. You do not need to upload `.po` files or open pull requests.
+Reviewed translations are copied into this repository every day and published at <https://docs.python.org/pa/>. You don't need to upload `.po` files or open pull requests.
 
 ## If you get stuck
 
-Ask a coordinator or open an issue if, for example:
+Ask a coordinator or open an issue if:
 
-- you cannot see Punjabi or your resource, or you cannot edit a string,
-- a check fails and you do not understand why,
-- you are unsure whether a word or markup should stay in English,
+- you can't see Punjabi or your resource, or you can't edit a string,
+- a check fails and you don't know why,
+- you're not sure if a word or markup should stay in English,
 - an existing translation looks wrong,
-- something looks like a Transifex configuration problem.
+- something looks like a Transifex setup problem.
 
-Please do not create a new project, resource, language or file to solve a problem yourself.
+Please don't create a new project, resource, language or file to fix it yourself.