SoK/Ideas/2024: Difference between revisions
(Remove idea with no mentor) |
No edit summary |
||
Line 110: | Line 110: | ||
'''Mentors:''' Nitin Tejuja @nitin.tejuja12:matrix.org, Emmanuel Charruau @allon:kde.org | '''Mentors:''' Nitin Tejuja @nitin.tejuja12:matrix.org, Emmanuel Charruau @allon:kde.org | ||
=== Cantor: Extend the embedded documentation for supported Computer Algebra Systems === | |||
'''Project type:''' Documentation, Coding | |||
'''Brief explanation:''' [https://cantor.kde.org/ Cantor] provides a graphical interface to multiple open-source computer algebra systems and programming languages. It is possible to download the documentation for some of the systems/languages from [https://store.kde.org/browse?cat=650&ord=latest KDE Store] for easier and more direct search in the documentation from within Cantor. For this, the documentation that is usually available in html format is converted to Qt's help files (s.a. [https://doc.qt.io/qt-5/qthelp-framework.html The Qt Help Framework]) and is uploaded to [https://store.kde.org KDE Store]. The download in Cantor is happening via [https://api.kde.org/frameworks/knewstuff/html/index.html KDE's NewStuff Framework]. At the moment only a few documentation files are available and the purpose of this project is to convert more of the publicly available documentation, tutorials or books to Qt's help format. | |||
'''Expected results:''' At the end of the project more documentation and for more systems should be available to download from the store for Cantor's users. Required steps: | |||
* become familiar with QtHelp | |||
* become familiar with the python scripts in Cantor's repository used to convert from html to QtHelp for already available documentation in the QtHelp format | |||
* create QtHelp files for newer versions for the already available documentations | |||
* work out similar scripts for other languages/systems where there is no embedded documentation available yet | |||
* upload new documentation files to [https://store.kde.org/browse?cat=650&ord=latest KDE Store] | |||
'''Knowledge Prerequisite:''' basic knowledge of python and html and basic understanding of how QtHelp works | |||
'''Mentor:''' Alexander Semke @asemke:kde.org | |||
== External links == | == External links == | ||
[https://invent.kde.org/teams/season-of-kde/2024 Season of KDE 2024] at Invent, with information how mentees can submit SoK proposals. | [https://invent.kde.org/teams/season-of-kde/2024 Season of KDE 2024] at Invent, with information how mentees can submit SoK proposals. |
Revision as of 20:06, 13 December 2023
Ideas
General information
All community members can submit an idea for a Season of KDE project. If you have an idea, reach out to the different people on the team to see if at least one core member would like to mentor and ask if you can add their contact info to the idea below.
Do not add SoK ideas with no mentor and no contact info.
Information for mentees
These ideas were contributed by our KDE developers and users. They are sometimes vague or incomplete. If you wish to submit a proposal based on these ideas, contact the developers and find out more about the particular suggestion you are interested in.
When writing your proposal or asking for help from the general KDE community do not assume people are familiar with the ideas here. KDE is really big!
If there is no specific contact given in the idea, you can ask questions on the general KDE development list [email protected]. See the KDE mailing lists page for information on available mailing lists and how to subscribe.
You need to submit your proposal to https://invent.kde.org/teams/season-of-kde/2024 before the deadline. Instructions for how to submit are included there.
Sample project
Project type: Coding / Web Development / Promo / Translation
Brief explanation:
Expected results:
Knowledge Prerequisite:
Mentor:
When adding an idea to this section, please try to include the following data:
- if the application is not widely known, a description of what it does and where its code lives
- a brief explanation
- the expected results
- pre-requisites for working on your project
- if applicable, links to more information or discussions
- mailing list or IRC channel for your application/library/module
- your name and email address for contact (if you're willing to be a mentor)
If you are not a developer but have a good idea for a proposal, get in contact with relevant developers first.
Ideas
Your Own Idea: Something that you're totally excited about
Project type: Coding / Web Development / Promo / Translation
Brief explanation: Do you have an awesome idea you want to work on with KDE but it isn't among the ideas below? That's cool. We love that! But please do us a favor: Get in touch with a mentor early on and make sure your project is realistic and within the scope of KDE. That will spare you and us a lot of frustration.
Expected results: Something you and KDE love
Knowledge Prerequisite: Probably C++ and Qt, but it depends on your project
Mentor: Try to see who in KDE is interested in what you want to work on and approach them. If you are unsure you can always ask in #kde-soc on Freenode IRC.
When adding an idea to this section, please try to include the following data:
- if the application is not widely known, a description of what it does and where its code lives
- a brief explanation
- the expected results
- pre-requisites for working on your project
- if applicable, links to more information or discussions
- mailing list or IRC channel for your application/library/module
- your name and email address for contact (if you're willing to be a mentor)
If you are not a developer but have a good idea for a proposal, get in contact with relevant developers first.
Sustainability 1: Testing and development of "KEcoLab"
Project type: Coding
Brief explanation: Sustainability is one of KDE's goals for the next two years. One aspect of this goal is to measure the energy consumption of KDE software. To do this, it is necessary to access the lab in KDAB, Berlin, which can now be done remotely using "KEcoLab". A list of to-dos can be found at the repository's Issues, including testing and integration into KDE software repositories. For the project, please put together a plan for resolving the issues you would be interested in working on and check with mentors before submitting a proposal.
Expected results: At the end of the project several of the to-dos in the above list should be resolved (while new ones may be added).
Knowledge Prerequisite: Knowledge of Git and Gitlab CI/CD, scripting (possibly including R), and a willingness to learn
Mentors: Karanjot Singh @drquark:kde.org, Joseph P. De Veaugh-Geiss @joseph:kde.org on Matrix
Sustainability 2: Improve "KdeEcoTest" emulation tool
Project type: Coding
Brief explanation: Measuring the energy consumption of KDE software is part of the Sustainable Software goal for KDE, as mentioned above. To achieve this goal it is necessary to use an emulation tool to create Standard Usage Scenario scripts. "KdeEcoTest" is one such tool, but it needs some fixes. A list of to-dos can be found at the FEEP repository's Issues for "KdeEcoTest".
Expected results: At the end of the project several of the to-dos in the above list should be resolved (while new ones may be added).
Knowledge Prerequisite: Coding in Python, basic knowledge of git and automation tools
Mentors: Emmanuel Charruau @allon:kde.org, Joseph P. De Veaugh-Geiss @joseph:kde.org on Matrix
Sustainability 3: Selenium automation of energy measurement / accessibility tests for KDE applications
Project type: Coding
Brief explanation: Both the Sustainable Software and the Accessibility "KDE For All" goals require automated testing -- which, in fact, is itself also fulfills the goal to "Automate and Systematize Internal Processes". "Selenium Webdriver AT-SPI" is just such a tool for achieving this (see Harald Sitter's blog post). The tooling is still in development, but we can already begin writing automated tests for several KDE applications and documenting the process for other developers.
Expected results: At the end of the project this and other issues should be addressed, while new ones may be added (see also the Issues at the repo):
- Automating the setup of Selenium Webdriver AT-SPI (see KDE Eco Selenium guide below for current setup procedure)
- Automating tests for a subset of KDE apps
- Bringing the KDE Eco Selenium guide up-to-date
Knowledge Prerequisite: Selenium
Mentors: Nitin Tejuja @nitin.tejuja12:matrix.org, Emmanuel Charruau @allon:kde.org
Cantor: Extend the embedded documentation for supported Computer Algebra Systems
Project type: Documentation, Coding
Brief explanation: Cantor provides a graphical interface to multiple open-source computer algebra systems and programming languages. It is possible to download the documentation for some of the systems/languages from KDE Store for easier and more direct search in the documentation from within Cantor. For this, the documentation that is usually available in html format is converted to Qt's help files (s.a. The Qt Help Framework) and is uploaded to KDE Store. The download in Cantor is happening via KDE's NewStuff Framework. At the moment only a few documentation files are available and the purpose of this project is to convert more of the publicly available documentation, tutorials or books to Qt's help format.
Expected results: At the end of the project more documentation and for more systems should be available to download from the store for Cantor's users. Required steps:
- become familiar with QtHelp
- become familiar with the python scripts in Cantor's repository used to convert from html to QtHelp for already available documentation in the QtHelp format
- create QtHelp files for newer versions for the already available documentations
- work out similar scripts for other languages/systems where there is no embedded documentation available yet
- upload new documentation files to KDE Store
Knowledge Prerequisite: basic knowledge of python and html and basic understanding of how QtHelp works
Mentor: Alexander Semke @asemke:kde.org
External links
Season of KDE 2024 at Invent, with information how mentees can submit SoK proposals.