Bug 364747

Summary: Applications in obsolete branches on d.k.o
Product: [Websites] docs.kde.org Reporter: Burkhard Lück <lueck>
Component: docs.kde.orgAssignee: Documentation Editorial Team <kde-doc-english>
Status: RESOLVED FIXED    
Severity: normal CC: luigi.toscano
Priority: NOR    
Version: unspecified   
Target Milestone: ---   
Platform: Other   
OS: Linux   
Latest Commit: Version Fixed In:
Sentry Crash Report:

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