« Return to Thread: Re: [framework-svn][14351] standard/trunk/documentation/manual/en/module_specs/ Zend_File_Transfer-Introduction.xml: [GENERIC] Zend_File_Transfer:
Re: [framework-svn][14351] standard/trunk/documentation/m
by thomasW
::
Rate this Message:
Hy Wil & others
I reverted the change as wished.
2 things to mention:
Related issues will be closed as won't fix. About 15 people picked on me
related to not knowing that these methods are not within 1.7 as they were
added nearly 1.7.2 and we now have 1.7.7. That was the initial reason of
this addition.
The second thing is that by simply searching the actual manual, I can find
many places where version numbers are mentioned. Also places where this is
not necessary. Not all, but some. We should aim to fix the whole manual and
have a policy.
I would ask all to think of it and make a comment on the new manual proposal
which Mikael (and me) are actually working on.
http://framework.zend.com/wiki/display/ZFPROP/Reorganization+of+documentation+-+Mickael+Perraud
As this new proposal also changes the way we have to work as translators I
would of course also ask all to read it, and comment it. Several good ideas
are already added but probably we have not thought of all posibilities.
Greetings
Thomas Weidner, I18N Team Leader, Zend Framework
http://www.thomasweidner.com
----- Original Message -----
From: "Wil Sinclair" <wil@...>
To: <thomas.weidner@...>; <fw-svn@...>;
<fw-svn-docs@...>
Sent: Friday, March 20, 2009 12:10 AM
Subject: RE: [framework-svn][14351]
standard/trunk/documentation/manual/en/module_specs/
Zend_File_Transfer-Introduction.xml: [GENERIC] Zend_File_Transfer:
> Hey Thomas et. al, I strongly discourage referring to version numbers in
> our documentation unless absolutely necessary. It tends to date our docs,
> plus it is simply unnecessary in many cases. I know that our documentation
> policies have made this necessary in the past, but I believe the correct
> course of action is to fix the policies. We can look at this following the
> 1.8 release.
>
> Not to pick on Thomas. I just saw an opportunity to bring this up. :P
>
>
>
> ,Wil
>
>
>
> From: thomas [mailto:null@...]
> Sent: Tuesday, March 17, 2009 11:38 AM
> To: fw-svn@...; fw-svn-docs@...
> Subject: [framework-svn][14351]
> standard/trunk/documentation/manual/en/module_specs/
> Zend_File_Transfer-Introduction.xml: [GENERIC] Zend_File_Transfer:
>
>
>
> Revision
>
> 14351
>
> Author
>
> thomas
>
> Date
>
> 2009-03-17 11:38:22 -0700 (Tue, 17 Mar 2009)
>
>
> Log Message
>
>
> [GENERIC] Zend_File_Transfer:
>
>
>
> - added some notes to the docu
>
>
> Modified Paths
>
>
> *
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
>
>
> Diff
>
>
> Modified:
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
> (14350 => 14351)
>
>
>
> ---
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
> 2009-03-17 18:19:43 UTC (rev 14350)
>
> +++
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
> 2009-03-17 18:38:22 UTC (rev 14351)
>
> @@ -211,7 +211,7 @@
>
> <listitem>
>
> <para>
>
> <emphasis role="strong">getFileSize($file =
> null)</emphasis>: This method will return the
>
> - real filesize for the given file.
>
> + real filesize for the given file. It is available
> since release 1.8.
>
> </para>
>
> </listitem>
>
>
>
> @@ -225,7 +225,7 @@
>
> <listitem>
>
> <para>
>
> <emphasis role="strong">getMimeType($files =
> null)</emphasis>: This method returns the
>
> - mimetype of a given transferred file.
>
> + mimetype of a given transferred file. It is available
> since release 1.8.
>
> </para>
>
> </listitem>
>
> </itemizedlist>
>
> @@ -357,10 +357,11 @@
>
> <title>Progress for file uploads</title>
>
>
>
> <para>
>
> - <code>Zend_File_Transfer</code> can give you the actual state
> of a fileupload in progress. To use
>
> - this feature you need either the <code>APC</code> extension
> which is provided with most default
>
> - PHP installations, or the <code>uploadprogress</code>
> extension. Both extensions are detected
>
> - and used automatically. To be able to get the progress you
> need to meet some prerequisites.
>
> + <code>Zend_File_Transfer</code> can give you the actual state
> of a fileupload in progress.
>
> + It is available since release 1.8. To use this feature you
> need either the <code>APC</code>
>
> + extension which is provided with most default PHP
> installations, or the <code>uploadprogress</code>
>
> + extension. Both extensions are detected and used
> automatically. To be able to get the progress
>
> + you need to meet some prerequisites.
>
> </para>
>
>
>
> <para>
>
>
I reverted the change as wished.
2 things to mention:
Related issues will be closed as won't fix. About 15 people picked on me
related to not knowing that these methods are not within 1.7 as they were
added nearly 1.7.2 and we now have 1.7.7. That was the initial reason of
this addition.
The second thing is that by simply searching the actual manual, I can find
many places where version numbers are mentioned. Also places where this is
not necessary. Not all, but some. We should aim to fix the whole manual and
have a policy.
I would ask all to think of it and make a comment on the new manual proposal
which Mikael (and me) are actually working on.
http://framework.zend.com/wiki/display/ZFPROP/Reorganization+of+documentation+-+Mickael+Perraud
As this new proposal also changes the way we have to work as translators I
would of course also ask all to read it, and comment it. Several good ideas
are already added but probably we have not thought of all posibilities.
Greetings
Thomas Weidner, I18N Team Leader, Zend Framework
http://www.thomasweidner.com
----- Original Message -----
From: "Wil Sinclair" <wil@...>
To: <thomas.weidner@...>; <fw-svn@...>;
<fw-svn-docs@...>
Sent: Friday, March 20, 2009 12:10 AM
Subject: RE: [framework-svn][14351]
standard/trunk/documentation/manual/en/module_specs/
Zend_File_Transfer-Introduction.xml: [GENERIC] Zend_File_Transfer:
> Hey Thomas et. al, I strongly discourage referring to version numbers in
> our documentation unless absolutely necessary. It tends to date our docs,
> plus it is simply unnecessary in many cases. I know that our documentation
> policies have made this necessary in the past, but I believe the correct
> course of action is to fix the policies. We can look at this following the
> 1.8 release.
>
> Not to pick on Thomas. I just saw an opportunity to bring this up. :P
>
>
>
> ,Wil
>
>
>
> From: thomas [mailto:null@...]
> Sent: Tuesday, March 17, 2009 11:38 AM
> To: fw-svn@...; fw-svn-docs@...
> Subject: [framework-svn][14351]
> standard/trunk/documentation/manual/en/module_specs/
> Zend_File_Transfer-Introduction.xml: [GENERIC] Zend_File_Transfer:
>
>
>
> Revision
>
> 14351
>
> Author
>
> thomas
>
> Date
>
> 2009-03-17 11:38:22 -0700 (Tue, 17 Mar 2009)
>
>
> Log Message
>
>
> [GENERIC] Zend_File_Transfer:
>
>
>
> - added some notes to the docu
>
>
> Modified Paths
>
>
> *
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
>
>
> Diff
>
>
> Modified:
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
> (14350 => 14351)
>
>
>
> ---
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
> 2009-03-17 18:19:43 UTC (rev 14350)
>
> +++
> standard/trunk/documentation/manual/en/module_specs/Zend_File_Transfer-Introduction.xml
> 2009-03-17 18:38:22 UTC (rev 14351)
>
> @@ -211,7 +211,7 @@
>
> <listitem>
>
> <para>
>
> <emphasis role="strong">getFileSize($file =
> null)</emphasis>: This method will return the
>
> - real filesize for the given file.
>
> + real filesize for the given file. It is available
> since release 1.8.
>
> </para>
>
> </listitem>
>
>
>
> @@ -225,7 +225,7 @@
>
> <listitem>
>
> <para>
>
> <emphasis role="strong">getMimeType($files =
> null)</emphasis>: This method returns the
>
> - mimetype of a given transferred file.
>
> + mimetype of a given transferred file. It is available
> since release 1.8.
>
> </para>
>
> </listitem>
>
> </itemizedlist>
>
> @@ -357,10 +357,11 @@
>
> <title>Progress for file uploads</title>
>
>
>
> <para>
>
> - <code>Zend_File_Transfer</code> can give you the actual state
> of a fileupload in progress. To use
>
> - this feature you need either the <code>APC</code> extension
> which is provided with most default
>
> - PHP installations, or the <code>uploadprogress</code>
> extension. Both extensions are detected
>
> - and used automatically. To be able to get the progress you
> need to meet some prerequisites.
>
> + <code>Zend_File_Transfer</code> can give you the actual state
> of a fileupload in progress.
>
> + It is available since release 1.8. To use this feature you
> need either the <code>APC</code>
>
> + extension which is provided with most default PHP
> installations, or the <code>uploadprogress</code>
>
> + extension. Both extensions are detected and used
> automatically. To be able to get the progress
>
> + you need to meet some prerequisites.
>
> </para>
>
>
>
> <para>
>
>
« Return to Thread: Re: [framework-svn][14351] standard/trunk/documentation/manual/en/module_specs/ Zend_File_Transfer-Introduction.xml: [GENERIC] Zend_File_Transfer:
| Free embeddable forum powered by Nabble | Forum Help |
