Re: [tortoisesvn] r19089 committed - Start adding the quick-start guide. There's not a lot there yet!

On 27 March 2010 18:03, Stefan Küng <tortoisesvn_at_gmail.com> wrote:
> On 27.03.2010 18:09, Simon Large wrote:
>> On 27 March 2010 12:30, Stefan Küng<tortoisesvn_at_gmail.com>  wrote:
>>> On Sat, Mar 27, 2010 at 13:21,<tortoisesvn_at_googlecode.com>  wrote:
>>>> Revision: 19089
>>>> Author: simon.tortoisesvn
>>>> Date: Sat Mar 27 05:20:31 2010
>>>> Log: Start adding the quick-start guide. There's not a lot there yet!
>>>
>>> Should we create a new issue for this to track the progress?
>>
>> Sure. There is already one in the old tracker, issue #436, but it
>> could be migrated.
>>
>> You asked earlier whether this should really be a separate document. I
>> asked this myself on the list a very long time ago but I don't think
>> there was much response. There are some reasons in the issue tracker
>> itself why I think it should be separate. Why do you think they should
>> be kept together?
>
> Several reasons actually:
> * it is (or will be) a good starting point, so it's also good to be part
> of the help file
> * having it separated means adjusting the translation scripts on our website
> * one more pot file for the translators to watch and work on

OK, I can add one more to that list: the ability to forward reference
the main section in the docs, which I can't do with a separate file. I
will revert the separate file and add to the main help file instead.
This is the new plan:

1. Combine and cut down the preface and introduction into a single
preface section.
2. Replace the existing section 1with the Quick Start guide. This will
have to include installation, but I may move the section on spell
checkers and language packs into a new appendix.

This is going to mean a bit of churn for the doc translators, but I
hope the result will be better. I think our existing preface and intro
is too long at the moment. I will create an issue to cover the
re-organisation part.

Simon

-- 
:       ___
:  oo  // \\      "De Chelonian Mobile"
: (_,\/ \_/ \     TortoiseSVN
:   \ \_/_\_/>    The coolest Interface to (Sub)Version Control
:   /_/   \_\     http://tortoisesvn.net
------------------------------------------------------
http://tortoisesvn.tigris.org/ds/viewMessage.do?dsForumId=757&dsMessageId=2466032
To unsubscribe from this discussion, e-mail: [dev-unsubscribe_at_tortoisesvn.tigris.org].