Description:
At the bottom of the pages of Code Thesaurus, I'd like to see text that offers a way for people to go and look at the correct file so they know what file they could edit if they spot things not implemented or how to correct some data that see is incorrect.
Requirements:
For the Reference page, one link below the column of the language data to link to something like "To add to or correct this, head over to GitHub" where "GitHub" links to the correct file corresponding to the language.
For the Compare page, two links of similar wording but one link under each language column.
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
Description:
At the bottom of each page, it says "Made with ❤ by Sarah Withee." But at this point, this project has been made along with additional contributors. The footer should reflect that!
Requirements:
In the footer part of base.html, add a link to the contributors page (see notes)
Use GitHub's API, find a way to ping the number of contributors and write a small bit of JavaScript code to get the number
Should say something along the lines of "Made with ❤ by Sarah Withee and x contributors." where x is the number of contributors. I'll leave the exact wording up to the issue taker.
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
If a language item that doesn't exist in the language currently shows up as if it was code. This shouldn't show up as monospaced code items but as regular text, or be distinguished somehow differently.
The PHP language is presently not on Code Thesaurus. I would love to see this added and the data types concept added to CT.
Requirements
Copy web/thesauruses/_meta/data_types.json to a web/thesauruses/php/ directory
Edit the data_types.json file to accurately reflect PHP and the latest major version of it.
Additional Notes
Please leave comments on this issue to ask questions or to claim the issue as yours. I'll keep it yours for a week then remove you in case someone else wants to work on it. (You can always reclaim it.)
Check out CONTRIBUTING.md for more information on how to contribute.
Description:
The home page of CT has a basic Bootstrap setup but it's not really well done. It's technically "responsive" but isn't really set up for great mobile viewing. I'd like to see this either redesigned entirely or have some of the issues fixed so it works a little better.
Requirements::
Has the main navigation bar have both a Home and About page. This menu will need to grow as time goes on.
It has a similar introductory description paragraph talking about the project
Has two sections for the "Learn a Language" and "See a Reference Sheet", both with drop down boxes like they have now.
A footer at the bottom with a link to the project itself. (This can stay the same as it is now.)
It should stay fairly simple but if you want to add a front-end framework, discuss it below and why you think it would be good to have it.
Notes:
Files to modify are in web/templates or web/static.
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
The Ruby language is presently not on Code Thesaurus. I would love to see this added and the data types concept added to CT.
Requirements
Copy web/thesauruses/_meta/data_types.json to a web/thesauruses/ruby/ directory
Edit the data_types.json file to accurately reflect Ruby and the latest major version of it.
Additional Notes
Please leave comments on this issue to ask questions or to claim the issue as yours. I'll keep it yours for a week then remove you in case someone else wants to work on it. (You can always reclaim it.)
Check out CONTRIBUTING.md for more information on how to contribute.
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
The functions in JavaScript are presently not on Code Thesaurus. I would love to see this added.
Requirements
Copy web/thesauruses/_meta/functions.json to a web/thesauruses/javascript/ directory
Edit the functions.json file to accurately reflect JavaScript and the latest major version of it.
Additional Notes
Please leave comments on this issue to ask questions or to claim the issue as yours. I'll keep it yours for a week then remove you in case someone else wants to work on it. (You can always reclaim it.)
Check out CONTRIBUTING.md for more information on how to contribute.
Description:
The directions to run the project on the README.md file show a really simplistic set of steps for working with Python to run the app. These can be incorrect due to operating systems, multiple Python installs (2.x and 3.x), or some other factors. Some want to use virtual environments instead.
This issue should make more specific directions for operating systems as well as include virtual environments.
Requirements:
Should have valid directions to run the app using Python 3 (probably with the python3 command instead)
Should offer a way to do virtual environments (pyenv or venv perhaps)
Should include directions a bit more specific to Linux.
Does not need to tell how to install Python, but should link to places to install it (or just show something like brew install python or apt-get install python3 or choco install python3 or other variations)
Does need to assume a user is not familiar with the install process of this app and try to make it as clear and friendly as possible
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
The README.md file shows how to run the newer Django framework, but some have said it's not correct and there's steps missing.
Please modify the README.md file so it has easy-to-follow and complete directions for newer people. (For things like "install Python" you can reference other URLs, but if it's specific to this repo, please be descriptive.) It should be accurate enough for beginners to Python as well as experts.
Description:
The information on the CONTRIBUTING.md file are out of date due to develop branch getting merged into master as well as the old framework now being officially gone. Update this file to match latest contribution suggestions.
Description:
When you land on the main CT page, the same language shows up for all three drop-downs to choose what languages you want to look up. It just looks odd to me. This issue should help choose a random language to select from the drop-down.
Requirements:
All three language drop-downs on the main page should have random languages specified
This can be done either by passing in the random languages from views.py's index function, or do it directly in the template index.html
Description:
There will be some differences between different versions of languages. One example is Python 2 vs 3. They are similar but also very different. Someone should be able to choose a language but also a version to compare using the Code Thesaurus system.
Requirements:
When the user requests a specific version of a language, the version should be reflected in the language that gets passed into the template.
When submitted from the front-end (#53), the view functions should know what language they picked up
The thesaurus files should be moved to subdirectories reflecting their version numbers
The Compare and Reference view functions should correctly pick up the correct files from those version
Notes:
While the front-end issue (#53) is separate from this back-end issue, they will have to be merged in together.
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
I would like a template so when one makes a new pull request, it's more of a form to fill out and can have some consistency and make it easy for myself or future maintainers to review.
Description:
This project has kind of been thrown together over past Hacktoberfests and on Sarah's free time. It's not really had tests added to it because of it's sort of hacky nature. I'd like to have unit test get added in to ensure old features continue to work and new features won't break the site when they go live.
Requirements:
Add some tests for the views
Add some tests for the models (if they've been added at this point)
Add some tests for the controllers (if they've been added at this point)
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
The functions in C++ are presently not on Code Thesaurus. I would love to see this added.
Requirements
Copy web/thesauruses/_meta/functions.json to a web/thesauruses/cplusplus/ directory
Edit the functions.json file to accurately reflect C++ and the latest major version of it.
Additional Notes
Please leave comments on this issue to ask questions or to claim the issue as yours. I'll keep it yours for a week then remove you in case someone else wants to work on it. (You can always reclaim it.)
Check out CONTRIBUTING.md for more information on how to contribute.
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
Description:
The Learn a Language and Reference Sheet pages of CT have a basic Bootstrap setups but it's not really well done. It's technically "responsive" but doesn't format the pages in a way that makes it easy to read or keeps the data together correctly when viewed on a mobile device. I'd like to see this redesigned entirely or fixed in a way that resolves these issues.
Requirements:
Borrows navigation bar formatting from the home page
Would display language data in a table-like way to make it easy to compare items ("Learn A Language" page) or easily look at items ("Reference Sheet" page)
Should appear in table-like form for desktop viewing
Should have data grouped together in the best format for mobile viewing
Footer at the bottom of the page should match the home page.
It should stay fairly simple but if you want to add a front-end framework, discuss it below and why you think it would be good to have it.
Notes:
Files to modify are in web/templates or web/static.
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
The functions in C# are presently not on Code Thesaurus. I would love to see this added.
Requirements
Copy web/thesauruses/_meta/functions.json to a web/thesauruses/csharp/ directory
Edit the functions.json file to accurately reflect C# and the latest major version of it.
Additional Notes
Please leave comments on this issue to ask questions or to claim the issue as yours. I'll keep it yours for a week then remove you in case someone else wants to work on it. (You can always reclaim it.)
Check out CONTRIBUTING.md for more information on how to contribute.
Description:
The directions to run the project on the README.md file show a really simplistic set of steps for working with Python to run the app. These can be incorrect due to operating systems, multiple Python installs (2.x and 3.x), or some other factors. Some want to use virtual environments instead.
This issue should make more specific directions for operating systems as well as include virtual environments.
Requirements:
Should have valid directions to run the app using Python 3 (probably with the python3 command instead)
Should offer a way to do virtual environments (pyenv or venv perhaps)
Should include directions a bit more specific to Mac.
Does not need to tell how to install Python, but should link to places to install it (or just show something like brew install python or apt-get install python3 or choco install python3 or other variations)
Does need to assume a user is not familiar with the install process of this app and try to make it as clear and friendly as possible
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
Description:
The directions to run the project on the README.md file show a really simplistic set of steps for working with Python to run the app. These can be incorrect due to operating systems, multiple Python installs (2.x and 3.x), or some other factors. Some want to use virtual environments instead.
This issue should make more specific directions for operating systems as well as include virtual environments.
Requirements:
Should have valid directions to run the app using Python 3 (probably with the python3 command instead)
Should offer a way to do virtual environments (pyenv or venv perhaps)
Should include directions a bit more specific to Windows.
Does not need to tell how to install Python, but should link to places to install it (or just show something like brew install python or apt-get install python3 or choco install python3 or other variations)
Does need to assume a user is not familiar with the install process of this app and try to make it as clear and friendly as possible
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
The /compare/ end point throws a key error. This is reproducible for multiple different language choices, few examples I tried out was Java and C++, C++ and C#.
Leave a comment on here with your question, or feel free to ask @geekygirlsarah on Twitter. You can also email [email protected] too.
Thanks!
We really value and appreciate the additions people make to Code Thesaurus, no matter how large or small. So thank you for taking the time to work on this!
I would like a templates so when one creates an issue, you can choose from a bug report or a feature enhancement. This will make it easier and more consistent for me to add new things for others, but also for others to add new issues too.
Description:
There will be some differences between different versions of languages. One example is Python 2 vs 3. They are similar but also very different. Someone should be able to choose a language but also a version to compare using the Code Thesaurus system.
Requirements:
On the home page, the languages listed under the two sections should list versions with them next to the languages in sorted order in the dropdowns
Ensure when submitted, unique values for different versions of the same language are sent to the server
On the Compare and Reference views, the version number should show up with the language name
Notes:
While this front-end issue is separate from the back-end issue (#54), they will have to be merged in together.
Claiming This Issue:
Please leave a comment below indicating your interest. I can then assign it to you.
If I don't see an update (comment, code, or PR), then I'll take your name off.
You would always be welcome to reclaim it again.
If you can't work on it, either leave a comment or remove yourself from the issue.
Description:
The home page for CT has drop-downs for language features and for actual programming languages. The language list is now dynamic and is based on available JSON files in the code base. The features need to be dynamically generated as well.
Requirements:
The features/concepts of programming languages need to pull from the meta_data.json file.
Sort the drop-down if it's not already sorted
Notes:
You can take a look at how Colin implemented the dynamic language generation part as this will be similar to it. Check out his PR at #34 .
The Rust language is presently not on Code Thesaurus. I would love to see this added and the data types concept added to CT.
Requirements
Copy web/thesauruses/_meta/data_types.json to a web/thesauruses/rust/ directory
Edit the data_types.json file to accurately reflect Rust and the latest major version of it.
Additional Notes
Please leave comments on this issue to ask questions or to claim the issue as yours. I'll keep it yours for a week then remove you in case someone else wants to work on it. (You can always reclaim it.)
Check out CONTRIBUTING.md for more information on how to contribute.