Complete Keyword Table (In English)

madiedgar commented 5 years ago

Hello 👋 Thank you so much for joining with us in this!

Issue #1: Complete Keyword Table (in English)

This is a very important document that will act as the backbone of the Legesher portfolio. Probably the best part is that no experience in code is necessary, for we will walk you through every step of the way!

The Guide

This keyword table guide is the main definition hub for translating the code for Legesher, and the main document you will be modifying in this issue. To begin, we need a very thorough Keyword Definition Table in English to best equip our multilingual creators to translate programming languages that were once only in English to be in their native language. SO AWESOME 😎

The Table

In the document described above, We need help in filling out the definitions and categories in where each of these keywords fall, so that for each new spoken language that is added (and programming language) the translations are 1:1.

Keyword: The current version of the Keyword Table pulls the unique keyword values from the language-template.yml file in the legesher-translations repo. Nothing needs to be changed in this column.
Definition: The basic definition of the specific keyword within the world of programming. Additional context can be added if the meaning of the word itself bridges the reason why programming languages selected the term to be used in such a way. This definition will give context to the translators on what word best fits the keyword within their own language to give the developers the best level of understanding.
Languages: List the programming languages which this keyword is utilized. The Keyword Table list is pulled from the language-template.yml file in the Legesher project, which denotes the full set of keywords for each individual programming language. This file can be helpful in determining what programming languages use the keyword. If you want to be fancy, writing a script to pull this information could be a fun activity.
Category: The main category that the keyword belongs to. If in another language the keyword is used in a different category, please note in the Notes section. Possible categories the keyword could fall into are as follows:
- Truth Values
- Logical Operators
- Loops
- User-Defined Structures
- References
- Exceptions
- Module Abstractions
- Variable Declarations
- Function Properties
- Debugging

A simple breakdown of the Python keywords, definitions, and categories can be found in the glossary

Notes: Any helpful information in describing / using this keyword.

An Example

Here's an example of what a keyword would look like in the table.

Keyword	Definition	Languages	Category	Notes
FALSE	Boolean logic for what is considered false	`python`, `c++`, `c#`, `javascript`, `julia`, `ocaml`, `ruby`, `rust`, `scala`, `swift`,`typescript`	`truth-values`

This is what the code above looks like when you're editing it in Markdown (the .md file extension). It can be useful for this issue to install a "Markdown Preview" extension on your text editor to help with the formatting.

| Keyword        | Definition     | Languages      | Category       | Notes          |
| :------------- | :------------- | :------------- | :------------- | :------------- |
|  FALSE | Boolean logic for what is considered **false** | `python`, `c++`, `c#`, `javascript`, `julia`, `ocaml`, `ruby`, `rust`, `scala`, `swift`,`typescript` |  `truth-values`  | |

The Branch

For this issue, we will be making changes on the branch called glossary-table. When we have all reached a complete list with our collaboration, we'll then merge the glossary-table branch into the master legesher-docs branch to be used for the Legesher project.

This is a huge task, so the more, the merrier! PR's will be merged if at least 10 full entries are added to the table (you can always do more than 10 😄).