Frameworks/Epics/KF5.0 Release Preparation/Necessary Files: Difference between revisions
Randomguy3 (talk | contribs) |
Randomguy3 (talk | contribs) |
||
Line 1: | Line 1: | ||
== README.md == | == README.md == | ||
Create or update README.md files for all frameworks. Ensure they contain at least the following: | Create or update README.md files for all frameworks ([http://daringfireball.net/projects/markdown/syntax ordinary Markdown], not GitHub's extension). Ensure they contain at least the following: | ||
<pre> | <pre> | ||
Line 16: | Line 16: | ||
- Git repository: <https://projects.kde.org/projects/frameworks/@framework_name@/repository> | - Git repository: <https://projects.kde.org/projects/frameworks/@framework_name@/repository> | ||
</pre> | </pre> | ||
Aim to tell people who know nothing about the framework what is aims to do (and why they should use it) in the Introduction section. Add other sections if there is other important information they should know (including examples if you think that would be helpful). You might want to highlight the most important classes, utilities or CMake macros. Try not to make it too long though (if the file is much over 50 lines, consider whether some of the information belongs somewhere else). | |||
If you can get someone not particularly familiar with the framework to help write the README.md file, even better - they are more likely to spot what information is useful. | |||
{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;" | {| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;" |
Revision as of 22:48, 22 December 2013
README.md
Create or update README.md files for all frameworks (ordinary Markdown, not GitHub's extension). Ensure they contain at least the following:
# @FrameworkName@ ## Introduction @Description of the framework@ ## Links - Mailing list: <https://mail.kde.org/mailman/listinfo/kde-frameworks-devel> - IRC channel: #kde-devel on Freenode - Git repository: <https://projects.kde.org/projects/frameworks/@framework_name@/repository>
Aim to tell people who know nothing about the framework what is aims to do (and why they should use it) in the Introduction section. Add other sections if there is other important information they should know (including examples if you think that would be helpful). You might want to highlight the most important classes, utilities or CMake macros. Try not to make it too long though (if the file is much over 50 lines, consider whether some of the information belongs somewhere else).
If you can get someone not particularly familiar with the framework to help write the README.md file, even better - they are more likely to spot what information is useful.
Status | Framework | Contact | |
---|---|---|---|
DONE | frameworkintegration | Aurélien Gâteau | |
DONE | karchive | Aurélien Gâteau | |
DONE | kauth | Aurélien Gâteau | |
DONE | kbookmarks | Aurélien Gâteau | |
DONE | kcmutils | Aurélien Gâteau | |
DONE | kcodecs | Aurélien Gâteau | |
DONE | kcompletion | Aurélien Gâteau | |
DONE | kconfig | Aurélien Gâteau | |
DONE | kconfigwidgets | Aurélien Gâteau | |
DONE | kcoreaddons | Aurélien Gâteau | |
DONE | kcrash | Aurélien Gâteau | |
DONE | kdbusaddons | Aurélien Gâteau | |
DONE | kde4support | Alex Merry | |
TO DO | kdeclarative | ? | <{{{3}}}> |
DONE | kded | Aurélien Gâteau | |
DONE | kdesignerplugin | Alex Merry | |
TO DO | kdesu | ? | <{{{3}}}> |
TO DO | kdewebkit | ? | <{{{3}}}> |
TO DO | kdnssd-framework | ? | <{{{3}}}> |
DONE | kdoctools | Aurélien Gâteau | |
TO DO | kemoticons | ? | <{{{3}}}> |
TO DO | kf5umbrella | ? | <{{{3}}}> |
DONE | kfileaudiopreview | Aurélien Gâteau | |
TO DO | kglobalaccel | ? | <{{{3}}}> |
TO DO | kguiaddons | ? | <{{{3}}}> |
TO DO | khtml | ? | <{{{3}}}> |
TO DO | ki18n | ? | <{{{3}}}> |
TO DO | kiconthemes | ? | <{{{3}}}> |
TO DO | kidletime | ? | <{{{3}}}> |
DONE | kimageformats | Alex Merry | |
IN PROGRESS | kinit | ? | |
TO DO | kio | ? | <{{{3}}}> |
TO DO | kitemmodels | ? | <{{{3}}}> |
TO DO | kitemviews | ? | <{{{3}}}> |
TO DO | kjobwidgets | ? | <{{{3}}}> |
TO DO | kjs | ? | <{{{3}}}> |
TO DO | kjsembed | ? | <{{{3}}}> |
TO DO | kmediaplayer | ? | <{{{3}}}> |
DONE | knewstuff | Aurélien Gâteau | |
TO DO | knotifications | ? | <{{{3}}}> |
TO DO | knotifyconfig | ? | <{{{3}}}> |
TO DO | kparts | ? | <{{{3}}}> |
TO DO | kplotting | ? | <{{{3}}}> |
TO DO | kprintutils | ? | <{{{3}}}> |
TO DO | kpty | ? | <{{{3}}}> |
TO DO | kross | ? | <{{{3}}}> |
TO DO | kservice | ? | <{{{3}}}> |
TO DO | ktextwidgets | ? | <{{{3}}}> |
TO DO | kunitconversion | ? | <{{{3}}}> |
TO DO | kwallet-framework | ? | <{{{3}}}> |
TO DO | kwidgetsaddons | ? | <{{{3}}}> |
TO DO | kwindowsystem | ? | <{{{3}}}> |
TO DO | kxmlgui | ? | <{{{3}}}> |
IN PROGRESS | plasma-framework | ? | |
DONE | solid | Aurélien Gâteau | |
IN PROGRESS | sonnet | ? | |
TO DO | threadweaver | ? | <{{{3}}}> |