Skip to content

ru-doc/java-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ru Doc - Русская документация
=============================
Проект создался с целью собрать русскоязычную документацию по всем сколь-нибудь
значимым проектам, составляющим поле программистской деятельности.
В первую очередь, это BOOST (www.boost.org), STL, OGRE (www.ogre3d.org),
JDK.

Перевод документации по Java
============================
Данный подпроект создался с целью перевести хотя бы официальную документацию
к платформе Java. Несмотря на обилие возможностей, многие разработчики, с
которыми я общался, понятия о них не имеют, наверное потому, что не читают
документацию. В итоге вместо использования итераторов применяют старый добрый 
C-подход итерации коллекций - 
for ( int i = 0; i < <colection>.size(); ++i )
	... = <colection>.get(i);
Надеюсь, что когда документация будет на родном языке, ее все-таки начнут читать.


Переводчикам
============
* Для перевода каждого пакета необходимо создать отдельную ветку с именем 
  пакета. Исключения могут составлять только очень мелкие пакеты (3-5 файлов),
  которые вы перевели на одном духу и которые войдут за один коммит. Однако
  в этом случае на коммит необходимо создать тег с именем переведенного пакета.

* Все файлы перевода хранить только в UTF-8. Другие кодировки не допускаются.

* При переводе терминов или иных выражений, вызывающих у вас затруднения, 
  создайте Issue с описанием проблемы перевода. В Issue обязательно указать
  имя файла и строку, где встретилось проблемное место.

* При переводе смещать строки кода не допускается. Помните, что это не реально
  компилируемый код, а только иллюстрация того, как устроена Java. Если вы
  сместите строки кода, отладчик потом укажет на неверную строку. Разумеется,
  что внутри комментариев можно распологать текст как угодно, лишь бы комментарий
  занимал столько же строк, сколько исходный.
  
* Перевод копирайта Oracle смотрите в пакете sunw.

About

Перевод документации Java SDK 1.6_20 на русский язык.

Resources

Stars

Watchers

Forks

Packages

No packages published