Re: [Tails-dev] integrate walkthrough in doc-rework

Poista viesti

Vastaa
Lähettäjä: alan
Päiväys:  
Vastaanottaja: tails-dev
Uudet otsikot: Re: [Tails-dev] integrate walkthrough in doc-rework
Aihe: Re: [Tails-dev] integrate walkthrough in doc-rework

Hi,

> From: sajolida <sajolida@???>
> Date: Fri, 8 Jul 2011 06:11:17 -0700
>
> >> I just had a look at the first section « About Tails ». As you already
> >> mentioned, at the moment in it there is basically:
> >> - Parts that could be merged into /doc/warning.
> >> - Other bits that are already addressed by /about. Plus, this secion is
> >> called « About Tails » almost like the page called « About » which is a
> >> bit confusing.
> >
> > Yes, but these page are to precise what is Tails about. They are like
> > subpages of /about. Perhaps this section could have a better name,
> > through.
>
> I just merged what I could from those pages in other places and renamed
> the section "General information". It now includes:
>
>     * Introduction to this documentation
>     * Why do you need anonymity?
>     * System requirements
>     * Warnings!

>
> That will surely change again and stuff will move around.
>

I had a look to your changes. Here are some comments

About commit 09d89fd: I think that it was nice that the beginning of the
about page was a short summary of the goal of Tails:

    Tails is a live CD or live USB that aims at preserving your privacy
    and anonymity. It helps you to:


    - use the Internet anonymously almost anywhere you go and on any computer:
      all connections to the Internet are forced to go through the Tor network;
    - leave no trace on the computer you're using unless you ask it explicitly.


    [...]


I'm not convinced that it is better with the new first paragraph:

    Tails is a live system: a complete operating-system designed to be
    used from a CD or a USB stick independently of the computer's
    original operating system.


    [...]


I think that it is better to start to summary the goal of Tails in a few
words that to explain what is a live system, which is already done lower
in the page in the "Use anywhere but leave no trace" section.

So I suggest to reword this first paragraph to something like:

    Tails is a live system that aims at preserving your privacy and
    anonymity. It helps you to use the Internet anonymously almost
    anywhere you go and on any computer but leave no trace.


Which might be followed by:

    It is a complete operating-system designed to be used from a CD or a
    USB stick independently of the computer's original operating system.


What do you think?

Cheers,

Alan


--