Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 432272 - Updates in KDE Documentation
Summary: Updates in KDE Documentation
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] KDE (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo KDE team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-08-22 09:27 UTC by Theo Chatzimichos (RETIRED)
Modified: 2013-03-09 21:15 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2012-08-22 09:27:16 UTC
Hello, below are a few proposals for the kde documentation.

Move to wiki:
- Meeting summaries (the meeting logs can stay in CVS)
- http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob;f=Documentation/CODE (and rename it to coding style)
- Everything under Hints and Troubleshooting

Update:
- Using sets
- Cleaning up KDE
The above two still mention kdeprefix and kde3, so one idea would be to move on the wiki their current form and update the relevant parts in the guide with less but useful info.
- "How you can help" chapter. Remove references of the HT, and replace that with overlay access info, and full gentoo dev info/link

Remove:
- KDE HT subproject and documentation of it
- KDE 3 part from KDE guide. The same text is in the front projspace, and that info is not so important nowadays to include it twice.
Comment 1 Johannes Huber (RETIRED) gentoo-dev 2012-08-22 22:26:02 UTC
> - KDE 3 part from KDE guide. The same text is in the front projspace, and that > info is not so important nowadays to include it twice.

done
Comment 2 Arne Flagge 2012-08-26 13:28:05 UTC
(In reply to comment #0)

> Move to wiki:
> - ...
> - Everything under Hints and Troubleshooting

Done, see http://wiki.gentoo.org/wiki/KDE/Hints and http://wiki.gentoo.org/wiki/KDE/Troubleshooting
Comment 3 Johannes Huber (RETIRED) gentoo-dev 2012-08-26 18:11:58 UTC
(In reply to comment #2)
> (In reply to comment #0)
> 
> > Move to wiki:
> > - ...
> > - Everything under Hints and Troubleshooting
> 
> Done, see http://wiki.gentoo.org/wiki/KDE/Hints and
> http://wiki.gentoo.org/wiki/KDE/Troubleshooting

Thanks Arne. Removed the content in the guide.
Comment 4 Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2012-08-26 18:19:46 UTC
this http://wiki.gentoo.org/wiki/KDEPIM-4.7_upgrade should also go under the KDE namespace, and I believe there should be a link in the kde guide (or in the kde projspace) pointing to those wiki articles
Comment 5 Arne Flagge 2012-08-30 08:35:43 UTC
(In reply to comment #0)
> Move to wiki:
> - ...
> -
> http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob;f=Documentation/
> CODE (and rename it to coding style)

Done, see http://wiki.gentoo.org/wiki/Project:KDE/Coding_style
Comment 6 Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2012-08-30 09:50:54 UTC
(In reply to comment #2)
> (In reply to comment #0)
> 
> > Move to wiki:
> > - ...
> > - Everything under Hints and Troubleshooting
> 
> Done, see http://wiki.gentoo.org/wiki/KDE/Hints and
> http://wiki.gentoo.org/wiki/KDE/Troubleshooting

Random idea: how about merging those to wiki/KDE instead of having them in separate pages?
Comment 7 Andreas K. Hüttel archtester gentoo-dev 2012-08-30 11:50:50 UTC
(In reply to comment #6)
> (In reply to comment #2)
> > (In reply to comment #0)
> > 
> > > Move to wiki:
> > > - ...
> > > - Everything under Hints and Troubleshooting
> > 
> > Done, see http://wiki.gentoo.org/wiki/KDE/Hints and
> > http://wiki.gentoo.org/wiki/KDE/Troubleshooting
> 
> Random idea: how about merging those to wiki/KDE instead of having them in
> separate pages?

Nah, smaller pages are easier to maintain.
Comment 8 Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2012-08-30 11:54:25 UTC
(In reply to comment #0)
> - Using sets

I was asked for clarification on that on IRC, I'm putting it here for reference. This section is totally irrelevant to kde, so either make it kde specific, or remove it completely, or move it somewhere else more appropriate and put a link in the kde guide
Comment 9 Andreas K. Hüttel archtester gentoo-dev 2012-08-30 12:30:07 UTC
(In reply to comment #8)
> (In reply to comment #0)
> > - Using sets
> 
> I was asked for clarification on that on IRC, I'm putting it here for
> reference. This section is totally irrelevant to kde, so either make it kde
> specific, or remove it completely, or move it somewhere else more
> appropriate and put a link in the kde guide

IMHO we should remove it completely, because it only clutters up the guide. Whoever wants to run live ebuilds should be able to figure that stuff out. See it as kind of an entrance exam... (and noone else actually needs the sets, you should use metapackages.)
Comment 10 Johannes Huber (RETIRED) gentoo-dev 2012-09-04 19:00:31 UTC
> Remove:
> - KDE HT subproject and documentation of it

Done by dilfridge/ago/creffet and replaced by kde-stable subproject.
Comment 11 Arne Flagge 2012-11-15 10:25:50 UTC
The remaining parts of the KDE guide are covered by the wiki articles. Overlay stuff is in http://wiki.gentoo.org/wiki/KDE/Overlay, sets stuff should be removed  (see comment #9), and localization stuff is in http://wiki.gentoo.org/wiki/KDE .
Comment 12 Michael Palimaka (kensington) gentoo-dev 2013-01-02 09:59:53 UTC
(In reply to comment #11)
> The remaining parts of the KDE guide are covered by the wiki articles.
> Overlay stuff is in http://wiki.gentoo.org/wiki/KDE/Overlay, sets stuff
> should be removed  (see comment #9), and localization stuff is in
> http://wiki.gentoo.org/wiki/KDE .

Thanks for that, I have removed the link to the guide in index.xml, and replaced kde4-guide.xml with a redirect to the wiki to avoid broken links.
Comment 13 Andreas K. Hüttel archtester gentoo-dev 2013-03-09 21:15:12 UTC
Looks like all is done here.