On Sat, Feb 12, 2011 at 2:59 AM, David Nelson <comme...@traduction.biz>wrote:
> Hi, :-) > > My *personal* view of the basic principles of a versioning system for > English documentation would be this: > > 1) The versioning system should be totally independent of Alfresco's > versioning, and should be maintained manually by the English docs > team, and based on the status of a document as considerered by the > working contributors. That way, the system is properly portable to any > working environment. > > 2) The reference version of English documentation should be stored on > the English docs team's working environment - Alfresco, or whatever > other system the team chooses to use. > > 3) The document's meta data seems to me to be the logical place to > store the versioning info. You get genuine portability and are not > tied to any particular working environment. Plus, you're not tied to > carefully preserving OS file names in order to preserve the versioning > information. > > 4) The principles and rules of the versioning system should be > explained on the wiki, but the English docs team should non be tied to > maintaining records of versions on the wiki. All that could be done in > an automated manner via Alfresco, and made publically consultable on a > login-free web page. > > 5) We should try and devise a system that is as easy to understand and > apply as possible - especially by people without a degree in > mathematics. :-D > > That would be my own 2 cents. What do people think about all that? > > And what specific information items would we need to track? > > David, I agree with what you have said here, especialy the "keep it simple" principle in item 5. Some items I think need to be in the meta data: * LibO version for which the doc has been verified * Publication date of the doc * Version number of the doc * List of embedded sections of common material? I'm not sure how that might work. I'll probably think of other items later. I am writing a separate note on the topic of embedded sections of common material, in response to Jean Weber's earlier note. Hal -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
