[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Single sourced summary (was Re: Beta Release Notes)



On Mon, 2008-03-03 at 19:50 +0000, Jonathan Roberts wrote:
> On 01/03/2008, Marc Wiriadisastra <marc mwiriadi id au> wrote:
> >
> > So whats going on with the single source summary then does that get
> >  replaced with the beta release notes?

The Alpha/Beta release notes (single wiki page) are a subset of the
SingleSourceSummary.

> I think so for now Marc...got my head in a big spin with the
> SingleSourceSummary! Not sure anybody totally understands it actually,
> though perhaps Karsten does and when he returns things may look
> rosier. For now though, feel free to move content from SSS or add
> stuff to the Release Notes :)

FWIW, Paul may also understand it, so we have being-hit-by-a-bus
protection.

Does this explanation work? ::

Problem -- multiple summaries (relnotes, press releases, wiki pages,
announcements, blog entries, articles) being written for a given release
(Alpha, Beta, RC, Gold), all repeating work; no clear place to go for a
good _summary_ of a given release.

Solution -- one single page that contains all the _potential_ content
(source) for any one of the given target summaries.  Call this the
SingleSourceSummary (SSS).

What the SSS is not -- 

        It is not a page meant to be read of itself:  two sections may
        contain nearly identical content but be written in two styles,
        such as "Big and happy!" and "Terse and descriptive".
        
        It does not require a consistent writing style for sections:
        see above examples
        
        Stable:  expect it to change constantly; don't use it with an
        Include() macro but copy/fork
        
What the SSS is --

        A resource for *anyone* writing about a given Fedora release
        
        A collaboration amongst various parts of Fedora -- Marketing,
        Docs, Rel Eng, etc.

-- 
Karsten Wade, Developer Community Mgr.
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41

Attachment: signature.asc
Description: This is a digitally signed message part


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]