Hi Peter,

I am not particularly concerned about the naming of files, my only real
interest is that there is a simple straight forward and reliable way to
identify the last edition of the file and where a previous edition of
that file exists, it can easily be researched and/or recovered.
All files with any name difference automatically acquire a modified
date, so identification is extremely simple. Inclusion of the author
initials serves no real worthwhile purpose, this identification is
already taken care of in the status sheet and the contributors section
of every guide chapter. Part of the reasoning behind my suggestion that
we all identify our initials to names on the status sheets.

If we had even a dozen or more regular contributors then a rigorous file
naming regime might serve a useful purpose.

Having files stored in just 2 sub-directories (sub-folders) eliminates
any possibility of the same file being edited twice. Personally I don't
give a "flying fig" what name the folders are given. If it were up to me
I would name them WIP (Work In Progress) to hold the most recently
edited editions of the files and Archive to hold previously edited
editions. I am yet to be convinced about the value of the Published
folder, but my view on that point is of no importance.

My one and only motivation is to simplify our workflow. To me
simplification and ease of understanding of our workflow is an important
part of getting and keeping new contributors involved. New contributors
are what the team will always need, because "creaking old geezers" like
you and I who understand how things were done "In the good ol' days"
won't be here forever.

OK, I've had my 2c ramble. Now I will leave it to the rest of the team
to decide what we do.

Best Regards
Dave

PS. I am subscribed, to the list so the private mail is unnecessary :)

-------- Original Message --------
From: Peter Schofield [mailto:[email protected]]
Sent: Saturday, September 12, 2020, 10:38 UTC
To: DaveB
Cc: LibreOffice
Subject: [libreoffice-documentation] Proposal for a change to the
NextCloud workflow

> Hello Dave
> 
> Another thought to help in keeping track of files and this comes from the day 
> when I used to earn money in tech writing.
> 
> First draft of a file and its filename use a sequence number and the 
> creator’s initials, for example IG7005-ManagingGraphicObjects-01-PS.odt.
> First review of a file, the reviewer adds their initials to the filename, for 
> example IG7005-ManagingGraphicObjects-01-PS-DB.odt.
> 
> Second draft of a file, the sequence number increases changing the filename 
> and the creator adds their initials, for example 
> IG7005-ManagingGraphicObjects-02-PS.odt.
> Second review of a file, the reviewer adds their initials to the filename, 
> for example IG7005-ManagingGraphicObjects-02-PS-DB.odt.
> 
> When the file is published, the filename does not have a sequence number or 
> any initials added, for example IG7005-ManagingGraphicObjects.odt.
> 
> This does give a good indication of which file is which and prevents the 
> wrong file from being edited again. It worked very well for me and a team of 
> technical writers.
> 
> We will agree to disagree about folder names, but still think Feedback is the 
> wrong name to use. A Published folder is a definite.
> 
> Regards
> 
> Peter Schofield
> [email protected]
> 
> 
> 
>> On 11 Sep 2020, at 16:18, DaveB <[email protected]> wrote:
>>
>> For the benefit of those who were not part of yesterday's team meeting,
>> or haven't yet read the minutes. I put forward a proposal as per the
>> subject line of this post.
>>
>> A copy of my proposal is available from:
>> https://nextcloud.documentfoundation.org/s/9FqwWK3m6Cy2zHQ
>> The proposal has 5 points together with my rational for the changes.
>>
>> If there are no reasonable objections, I propose to start updating our
>> NextCloud instance on Friday, 18th. September.
>>
>> Best Regards
>> Dave



-- 
To unsubscribe e-mail to: [email protected]
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

Reply via email to