Bug 364747 - Applications in obsolete branches on d.k.o
Summary: Applications in obsolete branches on d.k.o
Status: RESOLVED FIXED
Alias: None
Product: docs.kde.org
Classification: Websites
Component: docs.kde.org (show other bugs)
Version: unspecified
Platform: Other Linux
: NOR normal
Target Milestone: ---
Assignee: Documentation Editorial Team
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-06-25 12:44 UTC by Burkhard Lück
Modified: 2016-10-04 16:40 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Burkhard Lück 2016-06-25 12:44:21 UTC
https://docs.kde.org/index.php?language=en&package=kdeadmin shows KSystemLog in 4 branches, but the app has no kdelibs4 based version any more.

Same applies to nearly all other documentation on d.k.o.

Reason for these obsolete application branches on d.k.o is obviously, that the svn sources are only updated and obsolete checkout of docbooks are never deleted.

Probably fix we had already in the old generator script:

Delete all documentation before updating similar to scripty's behaviour.
Comment 1 Luigi Toscano 2016-06-25 12:49:29 UTC
I don't think that the generator script should be responsible for this. The generator should only generates what it found; the proper cleanup of the repository should be handled elsewhere (some other asynchronous check).
Comment 2 Burkhard Lück 2016-06-27 11:06:55 UTC
Using populate_documentation.sh + documentation_paths obsolete dirs in the en resp. documentation directory are preserved if:
* entry is removed from documentation_paths
* entry is moved to another module in documentation_paths
* traget dir is renamed in documentation_paths

Now we have in en resp. documentation:
stable4 223 docs on d.k.o, but actually only 169 docs 
trunk4 177 docs on d.k.o,  but actually only 154 docs
stable5 215 docs on d.k.o, but actually only 192 docs
trunk5 269 docs on d.k.o, but actually only 235 docs
total 894 (119%) docs on d.k.o, but actually only 750 (100%) docs

The only solution to get rid of the 19% obsolete docbooks I know is
to delete the content of dir en resp. documentation before updating
the documentation in docretriever.py
Comment 3 Burkhard Lück 2016-10-04 16:40:03 UTC
Git commit a0fbabd5e8689d2db9f14bead37de56f536ba944 by Burkhard Lück.
Committed on 04/10/2016 at 16:39.
Pushed by lueck into branch 'master'.

Cleanup en documentation before retrieving the new en docbooks
REVIEW:129074

M  +1    -1    kdedocs/docretriever.py

http://commits.kde.org/websites/docs-kde-org/a0fbabd5e8689d2db9f14bead37de56f536ba944