File naming proposal

Before we leap into renaming the files, I'd like to mention what the
numbers mean. This info is in "Producing LibreOffice User Guides" btw.

Hi Jean,

Before we leap into renaming the files, I'd like to mention what the
numbers mean. This info is in "Producing LibreOffice User Guides" btw.

---------------
File names take the following form: AABBCC3-Name,
where AA=book number,
BB=chapter number,
CC=book initials,
3=LibreOffice V3 (s/w version number),
Name=Chapter name.

For example, the third chapter of the Writer Guide, Working with Text,
has the following file name: 0203WG3-WorkingWithText.pdf
----------------

I agree with David that we don't need the book number, but I personally
find the chapter number quite handy as it sorts the chapters in order on
my computer. But it would need to go after the book initials if the book
number is dropped, or the various books would sort with all the chapter
1s first, the chapter 2s second, etc, if someone stores them all in one
folder like I often do.

We also discussed the need for the s/w version number to change from 3
to 33 (v3.3.x) or 34 (v3.4.x).

So I propose for the new filenames to take the form: CCnnBB-Name,
where CC=book initials,
nn=s/w version number,
BB=chapter number,
Name=Chapter name.

Example: WG3403-WorkingWithText.pdf is the third chapter of the Writer
Guide for LibreOffice 3.4.x

--Jean

I'll retrieve the info from past discussions on the subject, and will
take account of what you propose here, and will write back with
suggestions to be agreed upon before actually starting work on the
task.

Hi :slight_smile:
I agree with Jean. It might be good to have something after the chapter title
to show which documentation-release. So something like

CCnnBB-Name-v#
where # is a single digit. At most there are only likely to be about 2
re-releases of a chapter for a particular series. The 1st is a bit rushed and
so a 2nd might become necessary. Then during the course of the year there might
need to be an additional update, perhaps after about 2/3rds of the year for
stable releases.

The docs version number is only for double-checking the right one has reached
the web-sites or publisher.

Regards from
Tom :slight_smile:

I don't have the energy to type out all the reasons why I think that
is a BAD idea. Sorry, Tom.

--Jean

Hi :slight_smile:
Well you have more experience than me but i think it's better to suggest ideas
at this stage rather than have regrets later. Hopefully bad ideas get shot-down
fast as part of the process.

Regards from
Tom :slight_smile:

Making suggestions is good. And they deserve a more detailed response
than I can manage.