Re: [Documentation] Transmission wiki

Re: [Documentation] Transmission wiki

[Michael Tremer]

[-- Attachment #1: Type: text/plain, Size: 1850 bytes --]

Hello,

my advice for faster way of fixing mistakes:
Choose a language to start with (this is preferably English) and
then write the article. Create an outline, write chapters, add
screenshots...
Get as much feedback as you can get. Do the guide by the shown
steps and check for errors. THEN translate.

It's just easier if you don't need to fix minor issues in multiple
versions.

----

On the text itself. You guys need to fix the screenshot sizes. The page
loads a while and the screenshots are that huge that you cannot tell
where text is and where just crap is. Crop the stuff that does not
matter (e.g. services screenshot) and use thumbnails.

I would like to see the user pointed on how to create a samba share (bit
more detailed though). You mentioned WinSCP which is specific to Windows
and not very comfortable to use. Not sure if that is an option for
anybody.

I think we do not need the disclaimer. In our law, even ping, telnet and
nmap are illegal tools and it's up to the user what he is going to do
with transmission. Bittorrent by itself is not illegal.

Furthermore, why do we have a huge "installation section" on every
article? It is always the same. Why not create a very detailed guide and
always refer to it and tell the names of the packages to install?

Altogether the article is quite nice and to the point. One could collect
some links to the official transmission documentation for further
reading.

 -Michael

On Tue, 2012-01-17 at 13:39 +0100, Florian Ortmann wrote:
> Hi Erik,
> currently I've a little problem. My Fire doesn't at the moment and
> I've no time to fix it. So it would be nice if someone other could
> make a picture.
> 
> 
> Flo
> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation

Re: [Documentation] Transmission wiki

[WhyTea]

[-- Attachment #1: Type: text/plain, Size: 2494 bytes --]

Hi Michael,

if you think we don't need the disclaimer delete it. ;)

In my opinion it is easier to use/read if in every wiki the installation 
part is included.
I don't like inkomplete wikis so I've to read several wikis if I want to 
install one thing.

I will reduce the screenshots in size and colordeph so the loadtime will 
get better.

Daniel

Am 17.01.2012 17:29, schrieb Michael Tremer:
> Hello,
>
> my advice for faster way of fixing mistakes:
> Choose a language to start with (this is preferably English) and
> then write the article. Create an outline, write chapters, add
> screenshots...
> Get as much feedback as you can get. Do the guide by the shown
> steps and check for errors. THEN translate.
>
> It's just easier if you don't need to fix minor issues in multiple
> versions.
>
> ----
>
> On the text itself. You guys need to fix the screenshot sizes. The page
> loads a while and the screenshots are that huge that you cannot tell
> where text is and where just crap is. Crop the stuff that does not
> matter (e.g. services screenshot) and use thumbnails.
>
> I would like to see the user pointed on how to create a samba share (bit
> more detailed though). You mentioned WinSCP which is specific to Windows
> and not very comfortable to use. Not sure if that is an option for
> anybody.
>
> I think we do not need the disclaimer. In our law, even ping, telnet and
> nmap are illegal tools and it's up to the user what he is going to do
> with transmission. Bittorrent by itself is not illegal.
>
> Furthermore, why do we have a huge "installation section" on every
> article? It is always the same. Why not create a very detailed guide and
> always refer to it and tell the names of the packages to install?
>
> Altogether the article is quite nice and to the point. One could collect
> some links to the official transmission documentation for further
> reading.
>
>   -Michael
>
> On Tue, 2012-01-17 at 13:39 +0100, Florian Ortmann wrote:
>> Hi Erik,
>> currently I've a little problem. My Fire doesn't at the moment and
>> I've no time to fix it. So it would be nice if someone other could
>> make a picture.
>>
>>
>> Flo
>> _______________________________________________
>> Documentation mailing list
>> Documentation(a)lists.ipfire.org
>> http://lists.ipfire.org/mailman/listinfo/documentation
> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation

Re: [Documentation] Transmission wiki

[Michael Tremer]

[-- Attachment #1: Type: text/plain, Size: 3475 bytes --]



On Tue, 2012-01-17 at 17:53 +0100, WhyTea wrote:
> Hi Michael,
> 
> if you think we don't need the disclaimer delete it. ;)

Just wanted to know if there are some other reasons that I might have
missed.

> 
> In my opinion it is easier to use/read if in every wiki the installation 
> part is included.
> I don't like inkomplete wikis so I've to read several wikis if I want to 
> install one thing.

Well, if a user has done this one time, he would know how to install a
package. So most users skip that part and go on with the rest. I think
wiki articles should be to the point. We must require some kind of
knowledge of the reader and if he misses anything, there is still a
search function or the forums.

> 
> I will reduce the screenshots in size and colordeph so the loadtime will 
> get better.

Reduce the size with the implemented function in the wiki. Do not
reupload images and NEVER upload images in a bad quality. The wiki
resizes the images by itself and uses compression as well.

No comment on the rest?

 -Michael

> 
> Daniel
> 
> Am 17.01.2012 17:29, schrieb Michael Tremer:
> > Hello,
> >
> > my advice for faster way of fixing mistakes:
> > Choose a language to start with (this is preferably English) and
> > then write the article. Create an outline, write chapters, add
> > screenshots...
> > Get as much feedback as you can get. Do the guide by the shown
> > steps and check for errors. THEN translate.
> >
> > It's just easier if you don't need to fix minor issues in multiple
> > versions.
> >
> > ----
> >
> > On the text itself. You guys need to fix the screenshot sizes. The page
> > loads a while and the screenshots are that huge that you cannot tell
> > where text is and where just crap is. Crop the stuff that does not
> > matter (e.g. services screenshot) and use thumbnails.
> >
> > I would like to see the user pointed on how to create a samba share (bit
> > more detailed though). You mentioned WinSCP which is specific to Windows
> > and not very comfortable to use. Not sure if that is an option for
> > anybody.
> >
> > I think we do not need the disclaimer. In our law, even ping, telnet and
> > nmap are illegal tools and it's up to the user what he is going to do
> > with transmission. Bittorrent by itself is not illegal.
> >
> > Furthermore, why do we have a huge "installation section" on every
> > article? It is always the same. Why not create a very detailed guide and
> > always refer to it and tell the names of the packages to install?
> >
> > Altogether the article is quite nice and to the point. One could collect
> > some links to the official transmission documentation for further
> > reading.
> >
> >   -Michael
> >
> > On Tue, 2012-01-17 at 13:39 +0100, Florian Ortmann wrote:
> >> Hi Erik,
> >> currently I've a little problem. My Fire doesn't at the moment and
> >> I've no time to fix it. So it would be nice if someone other could
> >> make a picture.
> >>
> >>
> >> Flo
> >> _______________________________________________
> >> Documentation mailing list
> >> Documentation(a)lists.ipfire.org
> >> http://lists.ipfire.org/mailman/listinfo/documentation
> > _______________________________________________
> > Documentation mailing list
> > Documentation(a)lists.ipfire.org
> > http://lists.ipfire.org/mailman/listinfo/documentation
> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation

Re: [Documentation] Transmission wiki

[WhyTea]

[-- Attachment #1: Type: text/plain, Size: 3756 bytes --]

new pictures in the english wiki

Am 17.01.2012 19:30, schrieb Michael Tremer:
>
> On Tue, 2012-01-17 at 17:53 +0100, WhyTea wrote:
>> Hi Michael,
>>
>> if you think we don't need the disclaimer delete it. ;)
> Just wanted to know if there are some other reasons that I might have
> missed.
>
>> In my opinion it is easier to use/read if in every wiki the installation
>> part is included.
>> I don't like inkomplete wikis so I've to read several wikis if I want to
>> install one thing.
> Well, if a user has done this one time, he would know how to install a
> package. So most users skip that part and go on with the rest. I think
> wiki articles should be to the point. We must require some kind of
> knowledge of the reader and if he misses anything, there is still a
> search function or the forums.
>
>> I will reduce the screenshots in size and colordeph so the loadtime will
>> get better.
> Reduce the size with the implemented function in the wiki. Do not
> reupload images and NEVER upload images in a bad quality. The wiki
> resizes the images by itself and uses compression as well.
>
> No comment on the rest?
>
>   -Michael
>
>> Daniel
>>
>> Am 17.01.2012 17:29, schrieb Michael Tremer:
>>> Hello,
>>>
>>> my advice for faster way of fixing mistakes:
>>> Choose a language to start with (this is preferably English) and
>>> then write the article. Create an outline, write chapters, add
>>> screenshots...
>>> Get as much feedback as you can get. Do the guide by the shown
>>> steps and check for errors. THEN translate.
>>>
>>> It's just easier if you don't need to fix minor issues in multiple
>>> versions.
>>>
>>> ----
>>>
>>> On the text itself. You guys need to fix the screenshot sizes. The page
>>> loads a while and the screenshots are that huge that you cannot tell
>>> where text is and where just crap is. Crop the stuff that does not
>>> matter (e.g. services screenshot) and use thumbnails.
>>>
>>> I would like to see the user pointed on how to create a samba share (bit
>>> more detailed though). You mentioned WinSCP which is specific to Windows
>>> and not very comfortable to use. Not sure if that is an option for
>>> anybody.
>>>
>>> I think we do not need the disclaimer. In our law, even ping, telnet and
>>> nmap are illegal tools and it's up to the user what he is going to do
>>> with transmission. Bittorrent by itself is not illegal.
>>>
>>> Furthermore, why do we have a huge "installation section" on every
>>> article? It is always the same. Why not create a very detailed guide and
>>> always refer to it and tell the names of the packages to install?
>>>
>>> Altogether the article is quite nice and to the point. One could collect
>>> some links to the official transmission documentation for further
>>> reading.
>>>
>>>    -Michael
>>>
>>> On Tue, 2012-01-17 at 13:39 +0100, Florian Ortmann wrote:
>>>> Hi Erik,
>>>> currently I've a little problem. My Fire doesn't at the moment and
>>>> I've no time to fix it. So it would be nice if someone other could
>>>> make a picture.
>>>>
>>>>
>>>> Flo
>>>> _______________________________________________
>>>> Documentation mailing list
>>>> Documentation(a)lists.ipfire.org
>>>> http://lists.ipfire.org/mailman/listinfo/documentation
>>> _______________________________________________
>>> Documentation mailing list
>>> Documentation(a)lists.ipfire.org
>>> http://lists.ipfire.org/mailman/listinfo/documentation
>> _______________________________________________
>> Documentation mailing list
>> Documentation(a)lists.ipfire.org
>> http://lists.ipfire.org/mailman/listinfo/documentation
> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation

Re: [Documentation] Transmission wiki

[Erik K.]

[-- Attachment #1: Type: text/plain, Size: 364 bytes --]

Nice one :-)

Erik

Am 17.01.2012 um 10:15 schrieb Florian Ortmann:

> Hi Erik,
> at the moment I have no testing Fire at home! But I can make one at the university :)
> 
> Flo
> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation

Re: [Documentation] Transmission wiki

[Erik K.]

[-- Attachment #1: Type: text/plain, Size: 587 bytes --]

Flo,
you have an testing machine am i right ? May you can do this ?

Might be nice :-)

Erik


Am 17.01.2012 um 09:49 schrieb Florian Ortmann:

> Hi,
> would be nice if someone can make pictures in english. Because if you take a look at the english version of the Transmission wiki you will see that the picture is in german. So would be nice if someone can fix that.
> 
> Best regard
> Muddern
> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation

Re: [Documentation] Transmission Wiki

[Michael Tremer]

[-- Attachment #1: Type: text/plain, Size: 528 bytes --]

On Sat, 2012-01-14 at 22:15 +0100, WhyTea wrote:
> Hallöchen! Wink
> 
> Ein neues WIKI hat das Licht der Sonne erblickt.
> http://wiki.ipfire.org/de/addons/transmission/start
> 
> Bitte schaut doch mal drüber und gebt mir Eure Meinung dazu ab.
> 
> Danke und Gruß
> 
> Daniel
> 
> P.S.
> Extra für Dich Micha! ;)

And once again in English, please...

> _______________________________________________
> Documentation mailing list
> Documentation(a)lists.ipfire.org
> http://lists.ipfire.org/mailman/listinfo/documentation