Frameworks/Epics/KF5.0 Release Preparation/Necessary Files: Difference between revisions

From KDE Community Wiki
No edit summary
 
(14 intermediate revisions by 5 users not shown)
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, although if you have to you can get away with [http://www.stack.nl/~dimitri/doxygen/manual/markdown.html Doxygen's extensions]). Ensure they contain at least the following:


<pre>
<pre>
# @FrameworkName@
# @FrameworkName@
@One-line summary@


## Introduction
## Introduction
Line 12: Line 14:
## Links
## Links


- Home page: <https//projects.kde.org/projects/frameworks/@framework_name@
- Mailing list: <https://mail.kde.org/mailman/listinfo/kde-frameworks-devel>
- Mailing list: <https://mail.kde.org/mailman/listinfo/kde-frameworks-devel>
- IRC channel: #kde-devel on Freenode
- IRC channel: #kde-devel on Freenode
- 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 it 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.
Try to keep the width within 80 characters for most of the file (although long links, like the repository one at the end, may break that).
See karchive for an example README.md file that I (Alex Merry) consider a good example.


{| 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%;"
Line 36: Line 47:
{{FeatureDone|kdbusaddons| Aurélien Gâteau }}
{{FeatureDone|kdbusaddons| Aurélien Gâteau }}
{{FeatureDone|kde4support| Alex Merry }}
{{FeatureDone|kde4support| Alex Merry }}
{{FeatureTodo|kdeclarative| ? }}
{{FeatureDone|kdeclarative| ? }}
{{FeatureDone|kded| Aurélien Gâteau }}
{{FeatureDone|kded| Aurélien Gâteau }}
{{FeatureTodo|kdesignerplugin| ? }}
{{FeatureDone|kdesignerplugin| Alex Merry }}
{{FeatureTodo|kdesu| ? }}
{{FeatureDone|kdesu| ? }}
{{FeatureTodo|kdewebkit| ? }}
{{FeatureDone|kdewebkit| ? }}
{{FeatureTodo|kdnssd-framework| ? }}
{{FeatureDone|kdnssd-framework| ? }}
{{FeatureDone|kdoctools| Aurélien Gâteau }}
{{FeatureDone|kdoctools| Aurélien Gâteau }}
{{FeatureTodo|kemoticons| ? }}
{{FeatureDone|kemoticons| ? }}
{{FeatureTodo|kf5umbrella| ? }}
{{FeatureDone|kf5umbrella| ? }}
{{FeatureDone|kfileaudiopreview| Aurélien Gâteau }}
{{FeatureDone|kfileaudiopreview| Aurélien Gâteau }}
{{FeatureTodo|kglobalaccel| ? }}
{{FeatureDone|kglobalaccel| ? }}
{{FeatureTodo|kguiaddons| ? }}
{{FeatureDone|kguiaddons| ? }}
{{FeatureTodo|khtml| ? }}
{{FeatureDone|khtml| ? }}
{{FeatureTodo|ki18n| ? }}
{{FeatureDone|ki18n| ? }}
{{FeatureTodo|kiconthemes| ? }}
{{FeatureDone|kiconthemes| ? }}
{{FeatureTodo|kidletime| ? }}
{{FeatureDone|kidletime| ? }}
{{FeatureDone|kimageformats| Alex Merry }}
{{FeatureDone|kimageformats| Alex Merry }}
{{FeatureInProgress|kinit| ? }}
{{FeatureInProgress|kinit (refers to kdelibs 4 classes and library names, benchmarks are outdated)| ? }}
{{FeatureTodo|kio| ? }}
{{FeatureDone|kio| ? }}
{{FeatureTodo|kitemmodels| ? }}
{{FeatureDone|kitemmodels| ? }}
{{FeatureTodo|kitemviews| ? }}
{{FeatureDone|kitemviews| ? }}
{{FeatureTodo|kjobwidgets| ? }}
{{FeatureDone|kjobwidgets| ? }}
{{FeatureTodo|kjs| ? }}
{{FeatureDone|kjs| ? }}
{{FeatureTodo|kjsembed| ? }}
{{FeatureDone|kjsembed| ? }}
{{FeatureTodo|kmediaplayer| ? }}
{{FeatureDone|kmediaplayer| ? }}
{{FeatureDone|knewstuff| Aurélien Gâteau }}
{{FeatureDone|knewstuff| Aurélien Gâteau }}
{{FeatureTodo|knotifications| ? }}
{{FeatureDone|knotifications| ? }}
{{FeatureTodo|knotifyconfig| ? }}
{{FeatureDone|knotifyconfig| ? }}
{{FeatureTodo|kparts| ? }}
{{FeatureDone|kparts| ? }}
{{FeatureTodo|kplotting| ? }}
{{FeatureDone|kplotting| ? }}
{{FeatureTodo|kprintutils| ? }}
{{FeatureDone|kprintutils| ? }}
{{FeatureTodo|kpty| ? }}
{{FeatureDone|kpty| ? }}
{{FeatureTodo|kross| ? }}
{{FeatureDone|kross| ? }}
{{FeatureTodo|kservice| ? }}
{{FeatureDone|kservice| ? }}
{{FeatureTodo|ktextwidgets| ? }}
{{FeatureDone|ktexteditor| Alex Merry }}
{{FeatureTodo|kunitconversion| ? }}
{{FeatureDone|ktextwidgets| ? }}
{{FeatureTodo|kwallet-framework| ? }}
{{FeatureDone|kunitconversion| ? }}
{{FeatureTodo|kwidgetsaddons| ? }}
{{FeatureInProgress|kwallet-framework| Valentin Rusu }}
{{FeatureTodo|kwindowsystem| ? }}
{{FeatureDone|kwidgetsaddons| ? }}
{{FeatureTodo|kxmlgui| ? }}
{{FeatureDone|kwindowsystem| ? }}
{{FeatureInProgress|plasma-framework| ? }}
{{FeatureDone|kxmlgui| ? }}
{{FeatureDone|solid| Aurélien Gâteau }}
{{FeatureDone|solid| Aurélien Gâteau }}
{{FeatureInProgress|sonnet| ? }}
{{FeatureInProgress|sonnet| Martin Sandsmark }}
{{FeatureTodo|threadweaver| ? }}
{{FeatureDone|threadweaver| ? }}
|}
|}

Latest revision as of 12:32, 28 January 2014

README.md

Create or update README.md files for all frameworks (ordinary Markdown, not GitHub's extension, although if you have to you can get away with Doxygen's extensions). Ensure they contain at least the following:

# @FrameworkName@

@One-line summary@

## Introduction

@Description of the framework@

## Links

- Home page: <https//projects.kde.org/projects/frameworks/@framework_name@
- 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 it 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.

Try to keep the width within 80 characters for most of the file (although long links, like the repository one at the end, may break that).

See karchive for an example README.md file that I (Alex Merry) consider a good example.

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
DONE kdeclarative ?
DONE kded Aurélien Gâteau
DONE kdesignerplugin Alex Merry
DONE kdesu ?
DONE kdewebkit ?
DONE kdnssd-framework ?
DONE kdoctools Aurélien Gâteau
DONE kemoticons ?
DONE kf5umbrella ?
DONE kfileaudiopreview Aurélien Gâteau
DONE kglobalaccel ?
DONE kguiaddons ?
DONE khtml ?
DONE ki18n ?
DONE kiconthemes ?
DONE kidletime ?
DONE kimageformats Alex Merry
IN PROGRESS kinit (refers to kdelibs 4 classes and library names, benchmarks are outdated) ?
DONE kio ?
DONE kitemmodels ?
DONE kitemviews ?
DONE kjobwidgets ?
DONE kjs ?
DONE kjsembed ?
DONE kmediaplayer ?
DONE knewstuff Aurélien Gâteau
DONE knotifications ?
DONE knotifyconfig ?
DONE kparts ?
DONE kplotting ?
DONE kprintutils ?
DONE kpty ?
DONE kross ?
DONE kservice ?
DONE ktexteditor Alex Merry
DONE ktextwidgets ?
DONE kunitconversion ?
IN PROGRESS kwallet-framework Valentin Rusu
DONE kwidgetsaddons ?
DONE kwindowsystem ?
DONE kxmlgui ?
DONE solid Aurélien Gâteau
IN PROGRESS sonnet Martin Sandsmark
DONE threadweaver ?