Bug 438727

Summary: Non-branched Fedora Docs are inaccurately aggregated for each release
Product: [Fedora] Fedora Localization Reporter: Francesco Tombolini <tombo>
Component: WebsiteAssignee: Dimitris Glezos <dimitris>
Status: CLOSED NEXTRELEASE QA Contact: Diego Búrigo Zacarão <diegobz>
Severity: low Docs Contact:
Priority: low    
Version: unspecifiedCC: aalam, piotrdrag
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-11-08 18:51:24 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Francesco Tombolini 2008-03-24 18:57:31 UTC
Description of problem:
The stats of past versions of Fedora are influenced from the stats of the
current version.

An example is the Release Notes document.


Expected results:

The stats should be indipendent release by release.

If their value change inappropriately they loss their meaning.

Should be a solution for document (packages) that are not branched the creation
of new module definition?

Comment 1 Dimitris Glezos 2008-03-24 20:01:09 UTC
Francesco, could you please be more specific on what the problem is, and where
to see it in action?

Comment 2 Francesco Tombolini 2008-03-24 21:11:49 UTC
Yes Dimitris, in the teams or language pages, we can see the stats for the
releases F8 and F9, like in
http://translate.fedoraproject.org/languages/it

as you can see in
http://translate.fedoraproject.org/languages/it/fedora-9
and
http://translate.fedoraproject.org/languages/it/fedora-8
the Release notes doc is complete at 70% for all the releases, but it should be
100% for F8 and 70% for F9.

I have some doubt if this case is applicable to others modules too.

And another thing, while the team is working for F9, the stats for F8 and F9 go
forward together. So why are we show all the modules for 2 releases?

I think we should show only the current version (rawhide) and for the past
version only the branched modules or modules that was splitted (like Release notes).

Comment 3 Dimitris Glezos 2008-03-24 22:11:34 UTC
OK, I understood now. The problem is specific only for some Documentation
modules. These modules use directories to distinguish between branches, as you
can see from http://translate.fedoraproject.org/module/docs-release-notes.

Damned Lies handles Releases in a branch-way. For example, Fedora-9 for module X
has the "HEAD" branch but for Fedora 8 it uses the "fedora-8" branch. However,
these Docs modules only use one branch: "HEAD". That's why the releases page
cannot distinguish what we ship with each release.

Two ways to fix it:

 1. Change how Fedora handles Docs. Instead of having branches in sub-dirs, have
them in separate VCS branches.

 2. Extend Damned Lies to be able to do releases using directories instead of
only branches. Something like `<release name="fedora-9"><module id="foo"
dir="bar" /></>`.

Comment 4 Piotr Drąg 2008-11-08 18:51:24 UTC
Resolved with migration to git and using real branches.