Giter Site home page Giter Site logo

legesher / legesher-docs Goto Github PK

View Code? Open in Web Editor NEW
10.0 10.0 30.0 5.3 MB

All documentation for the Legesher package and further portfolio

License: Other

Ruby 86.72% Python 13.28%
developer-experience developer-tools documentation education hacktoberfest legesher open-source

legesher-docs's Introduction

Legesher

πŸ’» Code in any programming language using your native written ✏️language.

Programming with Legesher's dev tools empowers any developer to create without losing the art of innovation πŸ’‘, creativity 🎨, or collaboration 🀝 in translation.

David Dependency Status Pull Requests Welcome First Timers Only

Contribute on Github chat on Discord follow on Instagram follow on Twitter Subscribe on Mailchimp

Introduction

legesher 🌳 is the overarching developer tool for interchanging the written language within your code. This tool integrates with git to allow code changes to focus only on the updates and not on the translation.

Because innovation, creativity, and collaboration shouldn't be lost in translation

We are all about building bridges to empower others towards the direction of their lives. With Legesher, our bridges allow people to code in their native language. Legesher is designed for individuals where English is a second language and for diverse teams that span across many other barriers already.

Legesher is a tool that enables anyone to code in their native language. In order to do that we have several projects within the Legesher theme to support such an mission. We built Legesher on top of VS Code, a hackable text editor, and Git w/ GitHub, a version control tool, in order to give users as much of a personal invitation to programming as we could.

πŸ“’ Check if your native language is available in the Legesher translation repository! If not, we'd love your help to add it!!

Contributing

❀️Legesher relies on the passionate members of its community (both developer and non-developer alike) to keep delivering impactful tools to people all over the world.

Before contributing, be sure to consult Legesher's contribution guidelines and language conventions. As a member of our community, you must abide by our Code Of Conduct.

The Community ✨

Thanks goes to these wonderful people (emoji key):


Madison (Pfaff) Edgar

πŸ’» πŸ“†

Beomus

πŸ’Œ

Alex Buhai

πŸ’Œ

Alexsey Ramzaev

πŸ’»

Jasper Barzilaij

πŸ“–

Sergio

πŸ–‹

Jason Yeung

🚧

Anuj Singh

πŸ“†

saksham taneja

πŸ€”

Rutam Prita Mishra

πŸ“–

atom19-i

πŸ“–

This project follows the all-contributors specification. Contributions of any kind welcome!

legesher-docs's People

Contributors

allcontributors[bot] avatar blakecarson avatar charberg avatar christinapfaff avatar csteacher1 avatar dependabot[bot] avatar dominiqueflaaa avatar edgaracarneiro avatar ewelinasobora avatar fabio08 avatar jgtiu avatar joelibaceta avatar josephkmh avatar kichloo avatar knightwayne avatar machen2 avatar madiedgar avatar mark-c-hall avatar mehnazyunus avatar mhalseyperry avatar michizhou avatar ns61817 avatar onfilm avatar peggy-legesher avatar rajnish4unow avatar sameshl avatar tawhk avatar torianne02 avatar underscoreanuj avatar valerianpereira avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

legesher-docs's Issues

feat: add "first-timers-only" label to gemfile

First Timers Only

For our projects, we run a script that adds / updates all of the project labels. For hacktoberfest, we'd love to add a couple more to the mix so that we're consistent.

  • first-timers-only
  • up-for-grabs
  • help wanted

These issues should all be the same color. We also keep track of the labels within the documentation, so please add the labels to the markdown file.

πŸπŸ’» Welcome to Hacktoberfest 2020 πŸ’»πŸ

Screen Shot 2020-10-01 at 11 45 35 PM

Welcome to Hacktoberfest

..and welcome to our community! So many fun things to get into this Hacktoberfest like adding translations for your native written language 🌏 , sharpening & sharing your python skills 🐍 or even helping foster our community πŸ“Έ by creating instastories or managing our communication channels ❀️!

Stay in the know
New issues are added every day with varying difficulty levels for varying skillsets. Get notified of updates by clicking the πŸ‘β€πŸ—¨ watch button and save the repo for later reference by clicking the ⭐️ star button at the top right corner of this repo!

Ways to get involved

Legesher is a growing project with many different ways to get involved. Below is a list of all of the repositories that are participating in Hacktoberfest. You can search by label to find issues that are in the area of your expertise or an area you're wanting to learn / grow in!

Project Purpose
tree-sitter-legesher-python Tree-sitter python grammar used by text editors allowing Legesher's languages to be implemented
language-legesher-python Atom's programming language binding to allow syntax highlighting, code folding etc. to a specific grammar
legesher-translations Host and API of all the language translations for written languages for code keywords / concepts
legesher-dot-io Legesher's public website
legesher-pride Community-focused initiatives to add more value (and members) to our pride
legesher-docs Legesher's documentation hub. Will be transitioning to a documentation host soon.
legesher Git integration to collaborate with code and others in other languages

Important Hacktoberfest Information

🎁 If you contribute to a Legesher repository, then you will receive a handwritten letter from our founder expressing her deepest gratitude. You might also find some special edition stickers πŸ‘€.

As always, feel free to comment or ask any questions here as well.

Add Label Documentation for Roadmap Project Management

Label Documentation

We want to share our thoughts and process for Project Management of the Legesher project and make the repositories of the project similar so it's easy to navigate between each one.

  • Determine label set for the Legesher project
  • Assign colors for each of the labels
  • Document the purpose of each of the labels
  • Add the same labels and colors for the legesher repository
  • Add the same labels and colors for the tree-sitter-legesher-python repository
  • Add the same labels and colors for the language-legesher-python repository
  • Add the same labels and colors for the legesher-docs repository
  • Add the same labels and colors for the legesher-dot-io repository

Add Custom Label in Label Gem

Add New Custom Label to Gemfile

πŸŽ‰ FIRST TIMERS ONLY

We are adding a custom label to recognize the people who are contributing to the project by sharing the impact in other ways.

To complete this issue:

  • In the file /guide/legesher/labels/legesher-issue-labels.rb, please add this new custom label ✨ to the all_contributors_labels object (in alphabetical order please).
  "πŸ’Œ Opportunity: Marketing" => ["66CCFF", "People who help in marketing the repo/project"],
  • Update the /guide/legesher/roadmap.md to include the new opportunity!

Happy to help guide you along the way! Just reach out! πŸ˜„

Add New Dialect: Ukrainian (Python)

Adding Portuguese to the Legesher Translations for Python

Version 1 of Legesher only includes translations for the Python programming language. In order to add this language to the project, complete the steps detailed in the translation guide

Reviewers Needed

In order to add the translations into our database to use, the translations will need to be approved and accepted by 3 additional native / fluent speakers. If you would like to be one of the reviewers for this language, please mention in this issue! πŸ˜„

style: add Unibeautify linting

Add Unibeautify Linting

Being able to have formatted code that is aligned with the style guide is extremely important, not just for learning best practices but for the future of this project.

  • Please add a .unibeautifyrc.json file with a linting configuration to match the languages used within this repository.
  • Please correct the current files to match the linting configurations (this should be in the details after you commit the first task^

Welcoming the Community: CMS & Newsletters

How to build the community

with newsletters through a CMS

Legesher has a mailchimp account that has a list of people that already want to receive updates on Legesher's status. This is the main subscribe entry form on the legesher.io website.

For people wanting to collaborate/contribute, we're wanting to find a way they can be a part and do all the little mundane tasks of granting them access and getting the proper permissions and set up. Here's the list of things to complete thus far:

  • Create a collaborators / contributors tags to mailchimp list
  • Add link to list on the website
  • Add link to list on documentation
  • Create segment for Pre-Launch users
  • Add users to Legesher Team CMS
  • Send welcome email with all the necessary information! (described in a later issue)

docs: update repository according to legesher template

Elements of the Legesher Project Template include:

legesher-docs

  • Update README.md
    • Add Social Media
    • Add custom Legesher image
    • Add Getting Started section
    • Add Testing section
    • Add correlated shield badges
For the legesher logo image, use this Base64 encoding

logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNTAxLjE3IDUwMS4xNyI+PGRlZnM+PGNsaXBQYXRoIGlkPSJjbGlwLXBhdGgiPjxlbGxpcHNlIGN4PSIxNzUuMjMiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSJub25lIi8+PC9jbGlwUGF0aD48Y2xpcFBhdGggaWQ9ImNsaXAtcGF0aC0yIj48ZWxsaXBzZSBjeD0iMzI0LjIiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSJub25lIi8+PC9jbGlwUGF0aD48L2RlZnM+PHRpdGxlPlBlZ2d5LUhlYWRzaG90QWxwaGE8L3RpdGxlPjxnIHN0eWxlPSJpc29sYXRpb246aXNvbGF0ZSI+PGcgaWQ9IkxheWVyXzEiIGRhdGEtbmFtZT0iTGF5ZXIgMSI+PHBhdGggZD0iTTE2Mi40OCwzNjRjNzYuODgsNTEuNjUsMzYuNywyNTMuNDYsMjAxLDI1Mi4wOHM3Ni44My05NS4xLDc2LjgzLTk1LjEtMTksNDYuNjctNjguNywxMy41OC03MC0xNDUtNDEuMDktMTY0LjRTMTYyLjQ4LDM2NCwxNjIuNDgsMzY0WiIgZmlsbD0iI2ZmODk3NiIvPjxwYXRoIGQ9Ik0zMjIuNjEsNDU2YzEsMy42NSwyLjA5LDYuMTYsMy4zOSw3LjY5LTEyLjQ0LTQwLTEyLjIxLTgyLjMyLDQuNTYtOTMuNTcsMTQuODUtMTAtMjkuNzYtMTEuMzEtNzYuNzMtMTAuMjhsLTEwLjQyLDUuODYtMywyOS44M1MzMDkuMTUsNDA0LjUxLDMyMi42MSw0NTZaIiBmaWxsPSIjZjQ4ODc3IiBvcGFjaXR5PSIwLjUiIHN0eWxlPSJtaXgtYmxlbmQtbW9kZTptdWx0aXBseSIvPjxjaXJjbGUgY3g9IjI1MC41NSIgY3k9IjI1Ni45MSIgcj0iMTM4LjYyIiBmaWxsPSIjZmY4OTc2Ii8+PGcgY2xpcC1wYXRoPSJ1cmwoI2NsaXAtcGF0aCkiPjxlbGxpcHNlIGN4PSIxNzUuMjMiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSIjZmZmIi8+PGVsbGlwc2UgY3g9IjE4NS4zNyIgY3k9IjI0OS4xNCIgcng9IjMzLjAxIiByeT0iMzguNDMiIGZpbGw9IiMyNjI2MjYiLz48L2c+PGcgY2xpcC1wYXRoPSJ1cmwoI2NsaXAtcGF0aC0yKSI+PGVsbGlwc2UgY3g9IjMyNC4yIiBjeT0iMjUwLjEzIiByeD0iMzUuOTgiIHJ5PSI0MS44OSIgZmlsbD0iI2ZmZiIvPjxlbGxpcHNlIGN4PSIzMTQuMDYiIGN5PSIyNDkuMTQiIHJ4PSIzMy4wMSIgcnk9IjM4LjQzIiBmaWxsPSIjMjYyNjI2Ii8+PC9nPjxwb2x5Z29uIHBvaW50cz0iMTQwLjUzIDI4NC45NCAzNjAuMjggMjg0Ljk0IDMyMi4yMyAzMTYuMDIgMTY3LjkyIDMxOS4yMSAxNDAuNTMgMjg0Ljk0IiBmaWxsPSIjZmY4OTc2Ii8+PHBhdGggZD0iTTE5Ni4zNCwyNzMuN3MyMi4zMy0yNC45Miw1NS0yNC45Miw1My4yNCwyNC45Miw1My4yNCwyNC45Mi0xMiw1Ni40Mi01NC4xLDU2LjQyUzE5Ni4zNCwyNzMuNywxOTYuMzQsMjczLjdaIiBmaWxsPSIjZmJjNDk5Ii8+PHBhdGggZD0iTTE5Ni4zNCwyNzMuN3MyMi4zMy0yNC45Miw1NS0yNC45Miw1My4yNCwyNC45Miw1My4yNCwyNC45Mi0xMiwyOS43LTU0LjEsMjkuN1MxOTYuMzQsMjczLjcsMTk2LjM0LDI3My43WiIgZmlsbD0iI2ZkZTRkMyIvPjxwb2x5Z29uIHBvaW50cz0iMTQ0LjEgMjMzLjg3IDE2Ni4yOCAyNDcuNzQgMTQyLjUxIDI2MC4wMiAxNDQuMSAyMzMuODciIGZpbGw9IiNmZmYiLz48cG9seWdvbiBwb2ludHM9IjM1NS4zMyAyMzMuODcgMzMzLjE0IDI0Ny43NCAzNTYuOTEgMjYwLjAyIDM1NS4zMyAyMzMuODciIGZpbGw9IiNmZmYiLz48cGF0aCBkPSJNMjExLjEsMTIzLjgyczQ1LTIzLDU5LjY5LTIzLDEwLjQ3LDIzLDEwLjQ3LDIzWiIgZmlsbD0iI2ZmODk3NiIvPjxwYXRoIGQ9Ik0zNTIuMzYsMTE0LjY0YTkuNDMsOS40MywwLDAsMSw0LjE1LTE1Ljg5YzYuNDctMS42MSwxNi4xMi0uNzEsMzAuMDgsNy40NiwxOSwxMS4xMSwxOS4zMSwyNy4wNiwxNi4zLDM4LjM2LTEuODMsNi44OS0xMC41Niw5LjEtMTUuNjYsNC4xMloiIGZpbGw9IiMyNjI2MjYiLz48cGF0aCBkPSJNMTU0LjM5LDExNC42NGE5LjQzLDkuNDMsMCwwLDAtNC4xNS0xNS44OWMtNi40Ny0xLjYxLTE2LjEyLS43MS0zMC4wOCw3LjQ2LTE5LDExLjExLTE5LjMxLDI3LjA2LTE2LjMsMzguMzYsMS44Myw2Ljg5LDEwLjU2LDkuMSwxNS42Niw0LjEyWiIgZmlsbD0iIzI2MjYyNiIvPjwvZz48L2c+PC9zdmc+

  • Add CONTRIBUTING.md
  • Add CODE_OF_CONDUCT.md
  • Add linting configuration
  • Lint entire project
  • Add LICENSE.md
  • Update package.json

.github/*

  • Add FUNDING.yml
  • Add no-response.yml
  • Add lock.yml
  • Add stale.yml

Repository Settings

  • Add Legesher labels via gemfile
  • Configuring Sponsorship option
  • Update other repo's README's to include new project
  • Add repository description
  • Add repository tags
    • Examples include: tree-sitter, python, language, grammar, legesher, hacktoberfest, open-source,text-editor
  • Add repository website to repository description

Add GitHub Desktop GUI Tutorial

Documentation: Add GitHub Desktop GUI Tutorial

This is SUCH an important issue as it helps our community grow and allow the hurdles to contribute to lower. Here's the basic idea:

Create a comprehensive tutorial to help beginners, namely non-programmers, navigate and contribute to the Legesher project using the GitHub Desktop GUI.

Using the toolbox document as reference (also seen on the documentation site) create a step by step walk through tutorial of GitHub Desktop GUI.

Begin with installation instructions with pictures and take them along the journey to fork a Legesher repository to their account & local machine all using GitHub Desktop.

marketing: add repository to "awesome-for-non-programmers"

Awesome-For-Non-Programmers

Would love to add this repository to the awesome-for-non-programmers repository for non programmers to learn about open source opportunities that don't require a technical background.

With the Legesher project, there are a lot of opportunities for people of all backgrounds to contribute the skills they either want to grow in or give back. With a strong emphasis on written language translation, individuals who are bilingual have a great space to contribute. Individuals who want to grow in community development, marketing, writing impactful pieces of insight, or just want to learn more about the tech world have ample amounts of opportunities here as well!

More details can be found in their pull request template.

docs: update README with new project list

Update README with new project list

Yay for updated documentation! We added a new repository just for non-programmers and thus need to update our repositories project list with the new information! πŸŽ‰

The Legesher Projects section of the README needs to be updated in the following ways:

  • Add the legesher-pride repository as a row in the table
    • Follow the table conventions introduced by the other row items
    • Add the description: a non-programmer's dream to contributing to open source by sharing what they know and learning what's new

Update link in Github config

Update Github Config Link
The link in the .github/config.yml is incomplete. Please update the link to include the .html extension at the end of the url.

It should look like this:

We'd love to celebrate you and your contribution to the community. Let us say "Thank You" again, by sending you a [special gift](https://legesher.io/dreamteam.html) only given to special individuals like you who have chosen to give back.

Complete Keyword Table (In English)

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 πŸ˜„).

Add Contributor's Guide for Roadmap Project Management

Label Documentation

We want to share our thoughts and process for Project Management of the Legesher project and make the repositories of the project similar so it's easy to navigate between each one.

  • Describe Assignees to specific issues
  • Describe the process on how to contribute
  • Describe how to gain access to the repositories
  • Note the location where contributors receive credit πŸŽ‰

Add Github CLI Tutorial to Docs

Documentation: Add GitHub CLI Tutorial

This is SUCH an important issue as it helps our community grow and allow the hurdles to contribute to lower. Here's the basic idea:

Create a comprehensive tutorial to help beginners navigate and contribute to the Legesher project using the CLI.

Using the toolbox document as reference (also seen on the documentation site) create a step by step walk through tutorial of the CLI tool for GitHub.

Begin with installation instructions with pictures and take them along the journey to fork a Legesher repository to their account & local machine all using the CLI.

Add CONTRIBUTING.md file

Add a CONTRIBUTING.md file in the root of the repository that contains this content:

See the [Legesher contributing guide](https://github.com/legesher/legesher/blob/master/CONTRIBUTING.md)

Simple enough πŸ‘ Please ask to be assigned to this issue so we don't have duplicates πŸ˜„

feat: add "all-contributors" contribution types to rename-labels.rb

All Contributors Contributions

For our projects, we run a script that adds / updates all of the project labels. We want to honor all of the people and the different types of contributions that allow this project to develop further. We added the all-contributors bot to help us keep track of these.

We'll need to add a few items to the gemfile to help us track the type of contribution. This is taken from all-contributors:

Emoji/Type Represents Comments
πŸ’¬
question
Answering Questions Answering Questions in Issues, Stack Overflow, Gitter, Slack, etc.
πŸ›
bug
Bug reports links to issues reported by the user on this project
πŸ“
blog
Blogposts links to the blogpost
πŸ’Ό
business
Business Development people who execute on the business end
πŸ’»
code
Code links to commits by the user on this project
πŸ–‹
content
Content e.g. website copy, blog posts are separate
πŸ“–
doc
Documentation links to commits by the user on this project, Wiki, or other source of documentation
🎨
design
Design links to the logo/iconography/visual design/etc.
πŸ’‘
example
Examples links to the examples
πŸ“‹
eventOrganizing
Event Organizers links to event page
πŸ’΅
financial
Financial Support people or orgs who provide financial support, links to relevant page
πŸ”
fundingFinding
Funding/Grant Finders people who help find financial support
πŸ€”
ideas
Ideas & Planning
πŸš‡
infra
Infrastructure Hosting, Build-Tools, etc. Links to source file (like travis.yml) in repo, if applicable
🚧
maintenance
Maintenance people who help in maintaining the repo, links to commits by the user on this project
πŸ“¦
platform
Packaging porting to support a new platform
πŸ”Œ
plugin
Plugin/utility libraries links to the repo home
πŸ“†
projectManagement
Project Management
πŸ‘€
review
Reviewed Pull Requests
πŸ›‘οΈ
security
Security identify and/or reduce security threats, GDPR, Privacy, etc
πŸ”§
tool
Tools links to the repo home
🌍
translation
Translation links to the translated content
⚠️
test
Tests links to commits by the user on this project
βœ…
tutorial
Tutorials links to the tutorial
πŸ“’
talk
Talks links to the slides/recording/repo/etc
πŸ““
userTesting
User Testing links to user test notes
πŸ“Ή
video
Videos links to the video

Attributes to resolve this issue:

  • each label should have the color #66CCFF as associated with the label for an opportunity in rename-labels.rb
  • each label should follow this naming convention (adding emojis cause they're fun!) πŸ’¬ Opportunity: Question with the label description Answering Questions - Answering Questions in Issues, Stack Overflow, Gitter, Slack, etc. in rename-labels.rb
  • add the updated labels with their description to the roadmap documentation in legesher-docs/guide/legesher/roadmap.md.

Triage Issues

Following this guide


1. Is this issue a feature request? If so, copy/paste an answer I wrote that pointed them to the mailing list, and click close.  
2. Is this issue a request for help? If so, copy/paste an answer I wrote that pointed them to StackOverflow, and click close.  
3. Was this issue for an older version of Rails than is currently supported? If so, copy/paste an answer I wrote that asks if anyone knows if this affects a supported version of Rails.  
4. Did this issue provide enough information to reproduce the error? If no, copy/paste an answer I wrote that asks if they can provide a reproduction.  
5. If the issue has a reproduction, and it wasn’t on the latest Rails, try it against HEAD. If it still happened, leave a comment that it was still an issue.  
6. If we got to this point, this issue was pretty solid. Leave a comment that I had triaged it, and cc the maintainer of that relevant sub-system of Rails, so they could find issues that pertain to the things they work on.

Add ZenHub Documentation for Roadmap Project Management

Label Documentation

We want to share our thoughts and process for Project Management of the Legesher project and make the repositories of the project similar so it's easy to navigate between each one.

  • Determine sprint syntax for Github Milestones
  • Determine the sprint timeline for Github Milestones
  • Describe the purpose of each of the pipelines in the workspace
  • Describe story points and what each point might contain
  • Describe what is considered to be an Epic
  • Describe the current Epics and what is entailed within them
  • Describe Releases

docs: update repository according to legesher template

Elements of the Legesher Project Template include:

legesher-docs

  • Update README.md
    • Add Social Media
    • Add custom Legesher image
    • Add Getting Started section
    • Add Testing section
    • Add correlated shield badges
For the legesher logo image, use this Base64 encoding

logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNTAxLjE3IDUwMS4xNyI+PGRlZnM+PGNsaXBQYXRoIGlkPSJjbGlwLXBhdGgiPjxlbGxpcHNlIGN4PSIxNzUuMjMiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSJub25lIi8+PC9jbGlwUGF0aD48Y2xpcFBhdGggaWQ9ImNsaXAtcGF0aC0yIj48ZWxsaXBzZSBjeD0iMzI0LjIiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSJub25lIi8+PC9jbGlwUGF0aD48L2RlZnM+PHRpdGxlPlBlZ2d5LUhlYWRzaG90QWxwaGE8L3RpdGxlPjxnIHN0eWxlPSJpc29sYXRpb246aXNvbGF0ZSI+PGcgaWQ9IkxheWVyXzEiIGRhdGEtbmFtZT0iTGF5ZXIgMSI+PHBhdGggZD0iTTE2Mi40OCwzNjRjNzYuODgsNTEuNjUsMzYuNywyNTMuNDYsMjAxLDI1Mi4wOHM3Ni44My05NS4xLDc2LjgzLTk1LjEtMTksNDYuNjctNjguNywxMy41OC03MC0xNDUtNDEuMDktMTY0LjRTMTYyLjQ4LDM2NCwxNjIuNDgsMzY0WiIgZmlsbD0iI2ZmODk3NiIvPjxwYXRoIGQ9Ik0zMjIuNjEsNDU2YzEsMy42NSwyLjA5LDYuMTYsMy4zOSw3LjY5LTEyLjQ0LTQwLTEyLjIxLTgyLjMyLDQuNTYtOTMuNTcsMTQuODUtMTAtMjkuNzYtMTEuMzEtNzYuNzMtMTAuMjhsLTEwLjQyLDUuODYtMywyOS44M1MzMDkuMTUsNDA0LjUxLDMyMi42MSw0NTZaIiBmaWxsPSIjZjQ4ODc3IiBvcGFjaXR5PSIwLjUiIHN0eWxlPSJtaXgtYmxlbmQtbW9kZTptdWx0aXBseSIvPjxjaXJjbGUgY3g9IjI1MC41NSIgY3k9IjI1Ni45MSIgcj0iMTM4LjYyIiBmaWxsPSIjZmY4OTc2Ii8+PGcgY2xpcC1wYXRoPSJ1cmwoI2NsaXAtcGF0aCkiPjxlbGxpcHNlIGN4PSIxNzUuMjMiIGN5PSIyNTAuMTMiIHJ4PSIzNS45OCIgcnk9IjQxLjg5IiBmaWxsPSIjZmZmIi8+PGVsbGlwc2UgY3g9IjE4NS4zNyIgY3k9IjI0OS4xNCIgcng9IjMzLjAxIiByeT0iMzguNDMiIGZpbGw9IiMyNjI2MjYiLz48L2c+PGcgY2xpcC1wYXRoPSJ1cmwoI2NsaXAtcGF0aC0yKSI+PGVsbGlwc2UgY3g9IjMyNC4yIiBjeT0iMjUwLjEzIiByeD0iMzUuOTgiIHJ5PSI0MS44OSIgZmlsbD0iI2ZmZiIvPjxlbGxpcHNlIGN4PSIzMTQuMDYiIGN5PSIyNDkuMTQiIHJ4PSIzMy4wMSIgcnk9IjM4LjQzIiBmaWxsPSIjMjYyNjI2Ii8+PC9nPjxwb2x5Z29uIHBvaW50cz0iMTQwLjUzIDI4NC45NCAzNjAuMjggMjg0Ljk0IDMyMi4yMyAzMTYuMDIgMTY3LjkyIDMxOS4yMSAxNDAuNTMgMjg0Ljk0IiBmaWxsPSIjZmY4OTc2Ii8+PHBhdGggZD0iTTE5Ni4zNCwyNzMuN3MyMi4zMy0yNC45Miw1NS0yNC45Miw1My4yNCwyNC45Miw1My4yNCwyNC45Mi0xMiw1Ni40Mi01NC4xLDU2LjQyUzE5Ni4zNCwyNzMuNywxOTYuMzQsMjczLjdaIiBmaWxsPSIjZmJjNDk5Ii8+PHBhdGggZD0iTTE5Ni4zNCwyNzMuN3MyMi4zMy0yNC45Miw1NS0yNC45Miw1My4yNCwyNC45Miw1My4yNCwyNC45Mi0xMiwyOS43LTU0LjEsMjkuN1MxOTYuMzQsMjczLjcsMTk2LjM0LDI3My43WiIgZmlsbD0iI2ZkZTRkMyIvPjxwb2x5Z29uIHBvaW50cz0iMTQ0LjEgMjMzLjg3IDE2Ni4yOCAyNDcuNzQgMTQyLjUxIDI2MC4wMiAxNDQuMSAyMzMuODciIGZpbGw9IiNmZmYiLz48cG9seWdvbiBwb2ludHM9IjM1NS4zMyAyMzMuODcgMzMzLjE0IDI0Ny43NCAzNTYuOTEgMjYwLjAyIDM1NS4zMyAyMzMuODciIGZpbGw9IiNmZmYiLz48cGF0aCBkPSJNMjExLjEsMTIzLjgyczQ1LTIzLDU5LjY5LTIzLDEwLjQ3LDIzLDEwLjQ3LDIzWiIgZmlsbD0iI2ZmODk3NiIvPjxwYXRoIGQ9Ik0zNTIuMzYsMTE0LjY0YTkuNDMsOS40MywwLDAsMSw0LjE1LTE1Ljg5YzYuNDctMS42MSwxNi4xMi0uNzEsMzAuMDgsNy40NiwxOSwxMS4xMSwxOS4zMSwyNy4wNiwxNi4zLDM4LjM2LTEuODMsNi44OS0xMC41Niw5LjEtMTUuNjYsNC4xMloiIGZpbGw9IiMyNjI2MjYiLz48cGF0aCBkPSJNMTU0LjM5LDExNC42NGE5LjQzLDkuNDMsMCwwLDAtNC4xNS0xNS44OWMtNi40Ny0xLjYxLTE2LjEyLS43MS0zMC4wOCw3LjQ2LTE5LDExLjExLTE5LjMxLDI3LjA2LTE2LjMsMzguMzYsMS44Myw2Ljg5LDEwLjU2LDkuMSwxNS42Niw0LjEyWiIgZmlsbD0iIzI2MjYyNiIvPjwvZz48L2c+PC9zdmc+

  • Add CONTRIBUTING.md
  • Add CODE_OF_CONDUCT.md
  • Add linting configuration
  • Lint entire project
  • Add LICENSE.md
  • Update package.json

.github/*

  • Add FUNDING.yml
  • Add no-response.yml
  • Add lock.yml
  • Add stale.yml

Repository Settings

  • Add Legesher labels via gemfile
  • Configuring Sponsorship option
  • Update other repo's README's to include new project
  • Add repository description
  • Add repository tags
    • Examples include: tree-sitter, python, language, grammar, legesher, hacktoberfest, open-source,text-editor
  • Add repository website to repository description

feat: add "Language: Ruby" to label gemfile

Language: Ruby

For our projects, we run a script that adds / updates all of the project labels. For hacktoberfest, we'd love to add a couple more to the mix so that we're consistent.

  • Language: Ruby

This issue should have the color #F48370 associated with the label for a language. We also keep track of the labels within the documentation, so please add the labels to the markdown file.

πŸ‚ πŸ’» Welcome to Hacktoberfest 2021 πŸ‚πŸ’»

banner08CRredlogo

Happy Hacktoberfest

..and welcome to our community! This is our third Hacktoberfest and we're excited for what we'll build together! So many fun things to get into this Hacktoberfest like adding translations for your native written language 🌏 , sharpening & sharing your python skills 🐍 or even helping foster our community πŸ“Έ by creating content or managing our communication channels ❀️!

Stay in the know

πŸ†• New Issues
New issues are added every week with varying difficulty levels for diverse skill sets. Get notified of updates by clicking the πŸ‘β€πŸ—¨ watch button and save the repo for later reference by clicking the ⭐️ star button at the top right corner of this repo! We also will tweet every new issue as it comes out, so follow us @ legesherio 🐣.

⏰ Office Hours
This Hacktoberfest, we will be hosting office hours on our discord on Saturdays at 10am EST. Come with any questions about Legesher, contributing on GitHub, or anything else open source.

Ways to get involved

Legesher is a growing project with many different ways to get involved. Below is a list of all of our repositories that are participating in Hacktoberfest. You can search by label to find issues that are in the area of your expertise or an area you're wanting to learn / grow in! If you'd like to contribute in ways that might not fit within these repos, comment your ideas below!

Project Purpose
tree-sitter-legesher-python Tree-sitter python grammar used by text editors allowing Legesher's languages to be implemented
language-legesher-python Atom's programming language binding to allow syntax highlighting, code folding etc. to a specific grammar
legesher-translations Host and API of all the language translations for written languages for code keywords / concepts
legesher-dot-io Legesher's public website
legesher-pride Community-focused initiatives to add more value (and members) to our pride
legesher-docs Legesher's documentation hub. Will be transitioning to a documentation host soon.
legesher Git integration to collaborate with code and others in other languages

Goals

  1. legesher-translations: Develop API for translations of keywords (with documentation)
  2. tree-sitter-legesher-python & language-legesher-python : Incorporate translation API to support language translations for Python programming in Atom
  3. legesher-translations : Progress in the development of translations in Python
  • 50 languages in the Preparation Phase (currently 32)
  • 35 languages in the Active Development Phase (currently 20)
  • 10 languages in the Final Review Phase (currently 2)
  • 4 languages accepted as official translations

Important Hacktoberfest Information

🎁 If you contribute to a Legesher repository, then you will receive a handwritten letter from our founder expressing her deepest gratitude. You might also find some special edition stickers πŸ‘€.

As always, feel free to comment or ask any questions here as well.

Create Welcome Email

In Mailchimp create a welcome email to send ot subscribers when they first join the list

Incorrect README displayed

Describe the bug
Repo README is overwritten by .github/README.md, Hence we ares seeing ".github" as content instead of actual README content.

To Reproduce
Steps to reproduce the behavior:

  1. Go to the legesher-docs
  2. See the content of README.md below the files section

Expected behavior
Actual README

Screenshots

image

Possible Solution
Delete README.md from .github directory

Add Full Programming Language List to GitHub Labels

Add Full Programming Language List to GitHub Labels

We're adding new dialect translations incredibly fast, so having all of the programming language labels created and ready to go would be πŸ‘Œ!

To complete this issue:

πŸ’» πŸŽƒ Welcome to Hacktoberfest 2019πŸŽƒ πŸ’»

image

Welcome to Hacktoberfest

..and welcome to our community! So many fun things to get into this Hacktoberfest like adding translations for your native written language 🌏 , sharpening & sharing your python skills 🐍 or even helping foster our community πŸ“Έ by creating instastories or managing our communication channels ❀️!

Stay in the know
New issues are added every day with varying difficulty levels for varying skillsets. Get notified of updates by clicking the πŸ‘β€πŸ—¨ watch button and save the repo for later reference by clicking the ⭐️ star button at the top right corner of this repo!

Ways to get involved

Legesher is a growing project with many different ways to get involved. Below is a list of all of the repositories that are participating in Hacktoberfest. Search by label to find issues that are in the area of your expertise or an area you're wanting to learn / grow in!

Project Purpose
tree-sitter-legesher-python Tree-sitter python grammar used by text editors allowing Legesher's languages to be implemented
language-legesher-python Atom's programming language binding to allow syntax highlighting, code folding etc. to a specific grammar
legesher-translations Host and API of all the language translations for written languages for code keywords / concepts
legesher-dot-io Legesher's public website
legesher-pride Community-focused initiatives to add more value (and members) to our pride
legesher-docs Legesher's documentation hub. Will be transitioning to a documentation host soon.
legesher Git integration to collaborate with code and others in other languages

Important Hacktoberfest Information

🎁 If you contribute to a Legesher repository, then you will receive a handwritten letter from our founder expressing her deepest gratitude. You might also find some special edition stickers πŸ‘€.

As always, feel free to comment or ask any questions here as well.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.