Re: [PHP-DOC] request for splitting

2003-07-21 Thread Mehdi


some files under /language are really huge and a pain ;-) to translate.
What do you think about splitting them up to make them a bit easier to handle 
and translate?
e.g.:
control-structures: split by structure
types: split by type
...

opinions?

+1

Mehdi



--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


Re: [PHP-DOC] request for splitting

2003-07-21 Thread moshe doron

Jan Fabry [EMAIL PROTECTED] wrote in message
news:[EMAIL PROTECTED]
 (of course, I didn't 'Reply to list' - sorry Friedhelm!)

 On Sat, 2003-07-19 at 16:00, Friedhelm Betz wrote:
  some files under /language are really huge and a pain ;-) to translate.
  What do you think about splitting them up to make them a bit easier to
handle
  and translate?

 How would this make the translation easier? If you split up a large file
 into smaller parts, you still have to translate all those parts.

 I don't see an improvement in splitting up the files, unless you also
 rewrite parts of the documentation, to make things clearer or so.
+1

--
moshe


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP-DOC] request for splitting

2003-07-21 Thread Gabor Hojtsy
(of course, I didn't 'Reply to list' - sorry Friedhelm!)

some files under /language are really huge and a pain ;-) to translate.
What do you think about splitting them up to make them a bit easier to handle 
and translate?
How would this make the translation easier? If you split up a large file
into smaller parts, you still have to translate all those parts.
I don't see an improvement in splitting up the files, unless you also
rewrite parts of the documentation, to make things clearer or so.
Splitting alone can help in several points:

 - it's easier to face one smaller file to translate first, and
   then go on to the next small file next time, then translating
   one big one
 - thus translation work is better distributed

 - also if someone is not able to translate the whole part, the
   English untranslated parts will still be there in their latest
   available content (and not that one, which was imported by the
   time of some partial translation).
These were some of the main reasons we made the split of extension 
documentation to have one file per function.

Goba

--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


Re: [PHP-DOC] request for splitting

2003-07-20 Thread Jan Fabry
(of course, I didn't 'Reply to list' - sorry Friedhelm!)

On Sat, 2003-07-19 at 16:00, Friedhelm Betz wrote:
 some files under /language are really huge and a pain ;-) to translate.
 What do you think about splitting them up to make them a bit easier to handle 
 and translate?

How would this make the translation easier? If you split up a large file
into smaller parts, you still have to translate all those parts.

I don't see an improvement in splitting up the files, unless you also
rewrite parts of the documentation, to make things clearer or so.

Greetings,

Jan Fabry


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP-DOC] request for splitting

2003-07-20 Thread Salah Faya
+1 with Friedhelm,

I beleive that splitting large files will ease the translation because it
feels terrible when a translator work on one huge file and others in the
same team can't help him.. (Most of translators aim to get the smaller
files) So it will be better if it's splitted, and then you can easily give
everyone an assignment to work on a small file and get it all done in a
short time.

- Original Message -
From: Jan Fabry [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Sunday, July 20, 2003 8:10 PM
Subject: Re: [PHP-DOC] request for splitting


 (of course, I didn't 'Reply to list' - sorry Friedhelm!)

 On Sat, 2003-07-19 at 16:00, Friedhelm Betz wrote:
  some files under /language are really huge and a pain ;-) to translate.
  What do you think about splitting them up to make them a bit easier to
handle
  and translate?

 How would this make the translation easier? If you split up a large file
 into smaller parts, you still have to translate all those parts.

 I don't see an improvement in splitting up the files, unless you also
 rewrite parts of the documentation, to make things clearer or so.

 Greetings,

 Jan Fabry


 --
 PHP Documentation Mailing List (http://www.php.net/)
 To unsubscribe, visit: http://www.php.net/unsub.php



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



[PHP-DOC] request for splitting

2003-07-19 Thread Friedhelm Betz
Hi,

some files under /language are really huge and a pain ;-) to translate.
What do you think about splitting them up to make them a bit easier to handle 
and translate?
e.g.:
control-structures: split by structure
types: split by type
...

opinions?

Regards
Friedhelm



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP-DOC] request for splitting

2003-07-19 Thread Gabor Hojtsy
some files under /language are really huge and a pain ;-) to translate.
What do you think about splitting them up to make them a bit easier to handle 
and translate?
e.g.:
control-structures: split by structure
types: split by type
...

opinions?
+1, *but* please provide a plan on what the exact file names and 
locations will be, so traslators can also do the splitting in their own 
modules easily, and we can discuss the exact plan before doing the split.

Goba

--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


Re: [PHP-DOC] request for splitting

2003-07-19 Thread Friedhelm Betz
On Saturday 19 July 2003 18:27, Gabor Hojtsy wrote:
  some files under /language are really huge and a pain ;-) to translate.
  What do you think about splitting them up to make them a bit easier to
  handle and translate?
  e.g.:
  control-structures: split by structure
  types: split by type
  ...
 
  opinions?

 +1, *but* please provide a plan on what the exact file names and
 locations will be, so traslators can also do the splitting in their own
 modules easily, and we can discuss the exact plan before doing the split.

Of course, I'll do..

Friedhelm



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP-DOC] request for splitting

2003-07-19 Thread Philip Olson

   some files under /language are really huge and a pain ;-) to translate.
   What do you think about splitting them up to make them a bit easier to
   handle and translate?
   e.g.:
   control-structures: split by structure
   types: split by type
   ...
  
   opinions?
 
  +1, *but* please provide a plan on what the exact file names and
  locations will be, so traslators can also do the splitting in their own
  modules easily, and we can discuss the exact plan before doing the split.
 
 Of course, I'll do..

I always hate losing file history like this but guess it's for
the best.  Granted the old files will be preserved, but still.

Anyone that has attempted to locate include() docs will tell
you that this restructuring idea is a good one ;)

Regards,
Philip


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php