search

ConEmu / old-issues

Old issues for ConEmu project (import is pending)
http://conemu.github.io/
0 stars 1 forks source link

Helping with documentation #609

Open ConEmu opened 9 years ago

ConEmu commented 9 years ago

From thecybershadow on June 21, 2012 01:24:23

The StackOverflow ad mentions that help with documentation is needed, but I can't find specific plans or instructions anywhere. It would help if there was a project plan / to-do list / "documentation" category in issues. The project wiki is also not editable to outsiders.

I could help with Russian/English translation and improving wording/grammar where appropriate.

Original issue: http://code.google.com/p/conemu-maximus5/issues/detail?id=609

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 21, 2012 02:01:24

Project wiki (english) may be edited by the people, who has special privilege. I can grant it to persons interested.

Another way to improve wiki (available to any user) is writing comments to wiki pages.

Files (screenshoots hosted on this project) and russian wiki may be changed via svn only.

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 21, 2012 02:30:21

I just have grant you "Edit wiki" privilege. You may try it.

Some words about documention exists in RoadMap . Do you think, it must be more detailed plan?

  1. improving wording/grammar, of course
  2. Nearest pages, which must be translated/edited, I think, must be https://code.google.com/p/conemu-maximus5/wiki/ConEmuFAQ https://code.google.com/p/conemu-maximus5/wiki/AnsiEscapeCodes 3. And I think, each page of settings must have screenshot and description of options.

Any help will be appriciated :)

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 21, 2012 02:42:54

Labels: -Type-Other Type-Documentation

ConEmu commented 9 years ago

From thecybershadow on June 21, 2012 07:42:36

Is it possible to obtain read-only access to the Russian parts of the wiki, or at least the source code of the Russian FAQ page? Translation is much easier when it can be done "in place".

ConEmu commented 9 years ago

From thecybershadow on June 21, 2012 07:49:00

Never mind, found the source in SVN: https://code.google.com/p/conemu-maximus5/source/browse/wiki/ru/ConEmuFAQ.wiki

ConEmu commented 9 years ago

From thecybershadow on June 23, 2012 05:12:47

Непонятное место:

Создать файл можно после загрузки ! ConEmu , в этом случае в XML можно сохранить настройки, загруженные из реестра.

"Загрузка" в каком смысле? Кто будет сохранять в XML настройки из реестра (юзер или ! ConEmu )?

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 23, 2012 05:23:38

"Загрузка" - в смысле запуск. Шаги

  1. запустить ConEmu (без xml-файла), настройки загружаются из реестра
  2. создать пустой ConEmu .xml (рядом с ConEmu .exe или ConEmu C.exe)
  3. Открыть окно Settings (в заголовке должен появиться суффикс [xml]) и нажать кнопку Save settings
ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 23, 2012 05:24:40

Если считаешь, что и русский faq подправить надо - давай вариант

ConEmu commented 9 years ago

From thecybershadow on June 23, 2012 05:26:52

"Создать файл можно после запуска ! ConEmu , что позволяет скопировать настройки загруженные из реестра в XML-файл."

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 23, 2012 05:32:12

наверное все-таки так

Создать файл можно после запуска ! ConEmu , что позволяет сохранить загруженные из реестра настройки в XML-файл.

ConEmu commented 9 years ago

From thecybershadow on June 23, 2012 05:33:54

Можно. "Скопировать" яснее передает намерение (ответ на вопрос "зачем/кому это нужно") ИМО

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 23, 2012 05:39:16

Только непонятно "как" это можно сделать (в смысле скопировать). Написать про "Открыть Settings, нажать кнопку Save"?

ConEmu commented 9 years ago

From thecybershadow on June 23, 2012 05:41:26

Думаю, новая формулировка достаточно ясна. Если возникнет вопрос, можно добавить пункт FAQ (не зря целая секция про портабильность?)

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 24, 2012 08:56:47

Еще в очередь на вычитку и перевод https://code.google.com/p/conemu-maximus5/wiki/Settings?wl=en Буду наверное потихоньку, как позволит время, которое все уходит на программирование, описывать вкладки диалога настроек... И вот подумалось, там дофига будет... Может разнести по разделам? Каждая вкладка в отдельном wiki.

PS. Для удобства работы с тикетами я ссылочку сделал "Documentation issues" на вкладке "Issues". Как считаешь, если чего нового на перевод нужно будет - создавать новый Issue, или в этот постить?

ConEmu commented 9 years ago

From thecybershadow on June 24, 2012 09:02:10

Может разнести по разделам? Каждая вкладка в отдельном wiki.

Думаю идеальное решение было бы либо CHM, либо что-то которое позволяет строить CHM и Wiki из единого текста. CHM бы позволило сделать хелп-систему аля point-and-click (либо ссылка в всплывающих подсказках, либо по стандартной кнопке ? в заголовке диалога). В принципе, думаю не трудно будет построить что-то что берет HTML прямо с code.google.com и собирает из него CHM. У меня с этим опыт есть (thecybershadow.net/d/docs).

PS. Для удобства работы с тикетами я ссылочку сделал "Documentation issues" на вкладке "Issues". Как считаешь, если чего нового на перевод нужно будет - создавать новый Issue, или в этот постить?

Думаю проще новые тикеты делать, чтобы было сразу ясно что уже сделано, а что уже нет. Так людям которые "не в курсе" но хотят помочь легче будет найти чем заняться.

ConEmu commented 9 years ago

From Merly...@gmail.com on January 16, 2013 06:24:57

Не знал, куда лучше закинуть, пишу здесь.

  1. Имхо, опцию "End selection on typing" лучше переименовать в "Reset selection on typing" или в "Reset selection on input". Я бы выбрал второй вариант.
  2. "3s" в подсказках озадачивает - не всегда сразу догадаешься, что это "3d state". Нужно что-то другое придумать
  3. Для этой же опции 3s можно преобразовать в дополнительный чекбокс. Т.е. выделяешь опцию, становится доступным чекбокс "any key" и, скажем, "copy to clipboard"

И последнее - очень не хватает инструкции для людей, которые бы хотели предложить пару исправлений в переводах, но просто не могут догадаться, как и куда это сделать. Для таких людей доступ на запись в вики не нужен, им проще написать пару предложений в Issues. Возможно, кроме Concept и Defect есть смысл сделать тип issue Translation.

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on January 16, 2013 07:37:47

  1. "Reset" не подходит - оно может копирование выполнять, а не только сброс. Поменять "typing" на "input" наверное можно, мне без разницы.
  2. можно и полностью писать. Длинно, вот и сокращал.
  3. 3е состояние это для экономии места. В большинстве случаев его нагляднее радиокнопками заменять, но это будет 3-4 контрола вместо одного. А диалог и так насыщен донельзя.

Тип создать можно. На счет "интрукции" - не уверен. Что там писать в той инструкции?? Если кто помочь хочет - масса вариантов для связи, выбирай любой.

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on January 16, 2013 08:27:38

Хотя... "input any key" как-то "не по-русски"? Не?

ConEmu commented 9 years ago

From Merly...@gmail.com on January 16, 2013 08:33:53

  1. Reset selection - сброс выделения. Как нельзя подходит сюда. Вот "end" точно не подходит. "End selection" ближе скорее к "выделение закончено, больше ничего не будет выделяться, можно со спокойной душой набирать текст". Кроме своего опыта переводов, мне кажется, где-то я уже подобную опцию видел :) И лучше даже не просто "input", а "user input".
  2. Полностью писать не нужно, нужно как-то придумать коротко, но ясно.
  3. Я понимаю, что в большинстве случаев выгоднее использовать радио с 3 пунктами. Но в данном случае, имхо, выгоднее сделать доп. опцию, т.к. там уже есть одна - any key. Т.е. логично сделать - вкл/выкл + опция1 + опция2. А на данный момент получается, что вкл/выкл/опция1 + опция2. Смысла совмещать первую опцию с вкл/выкл никакого.

По поводу инструкции. Честно говоря, сказать что писать в инструкцию не могу, т.к. не знаю, что действительно нужно переводить и где. Вот в этом и проблема. Возможно в багах нужно подробнее описывать задания. Например, я не понимаю, что значит баг 616. Т.е. я вижу этот текст, но совсем не понимаю, что с ним делать. Там мешанина русского и английского и в варианте en, и в варианте ru. Что странно - если оригинал написан на одном из языков, логично предположить, что он будет полностью на этом языке.

ConEmu commented 9 years ago

From Merly...@gmail.com on January 16, 2013 08:52:43

Хотя... "input any key" как-то "не по-русски"? Не? Честно - не рассматривал как предложение в одну строчку. "Type any key" тоже слух режет.

ConEmu commented 9 years ago

From Merly...@gmail.com on January 16, 2013 10:14:00

Кстати, насколько я понимаю, опция "any key" позволяет снимать выделение при нажатии любой функциональной клавиши, не только клавиши с символом. В 130113 (не знаю, как раньше было) при отпускании shift'а (который был нажат для выделения), похоже, приходит keycode и выделение сбрасывается. Т.е. тут получается уже не "on user input", а просто автоматически сбрасывается выделение. Если так и планировалось, то опцию вообще можно (и нужно) назвать по-другому, т.к. юзер вроде бы ничего и не вводит :)

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on January 16, 2013 11:47:23

"Finish selection"? ) Хотя и "Reset" при наличии рядом опции наверное нормально будет.

На счет перевода. Многие странички писались в течение длительного времени, по мере возможности, на языке на котором "подумалось", кое-что вообще копипастилось. На счет 616-го - русский и английский файлы идентичны (за исключением одного абзаца). Так что там нужно делать перевод "двусторонний", ну типа привести файл к соответствующему языку. Как всегда все упирается во время, лишнего ни у кого не наблюдается. Тот же Whatsnew - стараюсь писать на английском, потому что переводить времени нет, даже обновить русскую версию странички перед выкладкой новой сборки... голова не всегда соображает как сказать по-русски то что на английском в 3 слова влезло.

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on January 16, 2013 14:27:38

Добавлена страничка https://code.google.com/p/conemu-maximus5/wiki/ConEmuHelping Если чего непонятно или есть чего туда добавить - пишите.

Добавлен шаблон для Issue "О документации и переводе", в самом конце странички https://code.google.com/p/conemu-maximus5/wiki/Issues?tm=3

ConEmu commented 9 years ago

From rogersil...@gmail.com on June 05, 2013 04:38:47

Hi, I would like to help improve some of the English documentation - please give me wiki edit rights if you would like me to do so.

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on June 05, 2013 04:57:13

@ rogersillito Done

ConEmu commented 9 years ago

From leon.zac...@gmail.com on October 15, 2013 05:59:05

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on October 15, 2013 06:13:21

@ leon Done

ConEmu commented 9 years ago

From leon.zac...@gmail.com on October 17, 2013 04:45:57

it didnt work sorry

On 15/10/2013, conemu-maximus5@googlecode.com conemu-maximus5@googlecode.com wrote:

ConEmu commented 9 years ago

From ConEmu.M...@gmail.com on October 17, 2013 05:38:23

What are you trying to do? Show screenshot.