Сообщение А вот еще одна революционная идея (xml-комментарии) от 06.04.2016 15:47
Изменено 06.04.2016 23:56 Shmj
Хочу такого:
Т.е. чтобы xml-комментарии отделить от кода, и тем не менее чтобы они всегда были под рукой, т.е. чтобы не нужно было открывать спец. окно для написания комментов а интегрировать окно для написания кода и комментов. Но чтобы котлеты (код) отдельно, комменты (мухи) отдельно.
Основной минус того что есть сейчас -- размазывается обзор. Часто мне и так понятно что делает код и комменты только мешают. Из названий параметров я и так понимаю что за значение передается. А xml-комменты закрывают пол экрана. Некоторые любят на целый экран писать. Ну мешает же...
Выход -- xml-комменты должны быть в отдельных xml-файлах, но чтобы не было соблазна их не писать, окошко для написания комментов должно быть все время под рукой. Для этого разделяем окно редактора на 2 части (ессестно, можно мышкой менять ширину фрейма или вообще закрыть) и во второй части пишем комменты. Притом там можно автоматом генерить поля для каждого метода: для общего описания, параметров, возращаемого значения и пр.
Если вы работаете с кодом -- комменты вам постоянно не нужны -- вы и так помните все. А если нужно писать комменты -- просто растягиваете левое окошко и в авто-сгенеренном шаблоне все пишите.
Хотите?
=====================================================
|
Описание | public void Fun1()
метода | {
| }
|
|
|
|
=====================================================
Т.е. чтобы xml-комментарии отделить от кода, и тем не менее чтобы они всегда были под рукой, т.е. чтобы не нужно было открывать спец. окно для написания комментов а интегрировать окно для написания кода и комментов. Но чтобы котлеты (код) отдельно, комменты (мухи) отдельно.
Основной минус того что есть сейчас -- размазывается обзор. Часто мне и так понятно что делает код и комменты только мешают. Из названий параметров я и так понимаю что за значение передается. А xml-комменты закрывают пол экрана. Некоторые любят на целый экран писать. Ну мешает же...
Выход -- xml-комменты должны быть в отдельных xml-файлах, но чтобы не было соблазна их не писать, окошко для написания комментов должно быть все время под рукой. Для этого разделяем окно редактора на 2 части (ессестно, можно мышкой менять ширину фрейма или вообще закрыть) и во второй части пишем комменты. Притом там можно автоматом генерить поля для каждого метода: для общего описания, параметров, возращаемого значения и пр.
Если вы работаете с кодом -- комменты вам постоянно не нужны -- вы и так помните все. А если нужно писать комменты -- просто растягиваете левое окошко и в авто-сгенеренном шаблоне все пишите.
Хотите?
А вот еще одна революционная идея (xml-комментарии)
Хочу такого:
Т.е. чтобы xml-комментарии отделить от кода, и тем не менее чтобы они всегда были под рукой, т.е. чтобы не нужно было открывать спец. окно для написания комментов а интегрировать окно для написания кода и комментов. Но чтобы котлеты (код) отдельно, комменты (мухи) отдельно.
Основной минус того что есть сейчас -- размазывается обзор. Часто мне и так понятно что делает код и комменты только мешают. Из названий параметров я и так понимаю что за значение передается. А xml-комменты закрывают пол экрана. Некоторые любят на целый экран писать. Ну мешает же...
Выход -- xml-комменты должны быть в отдельных xml-файлах, но чтобы не было соблазна их не писать, окошко для написания комментов должно быть все время под рукой. Для этого разделяем окно редактора на 2 части (ессестно, можно мышкой менять ширину фрейма или вообще закрыть) и во второй части пишем комменты. Притом там можно автоматом генерить поля для каждого метода: для общего описания, параметров, возращаемого значения и пр.
Если вы работаете с кодом -- комменты вам постоянно не нужны -- вы и так помните все. А если нужно писать комменты -- просто растягиваете левое окошко и в авто-сгенеренном шаблоне все пишите.
Хотите?
=====================================================
|
Описание | public void Fun1()
метода | {
editable | }
|
|
|
|
=====================================================
Т.е. чтобы xml-комментарии отделить от кода, и тем не менее чтобы они всегда были под рукой, т.е. чтобы не нужно было открывать спец. окно для написания комментов а интегрировать окно для написания кода и комментов. Но чтобы котлеты (код) отдельно, комменты (мухи) отдельно.
Основной минус того что есть сейчас -- размазывается обзор. Часто мне и так понятно что делает код и комменты только мешают. Из названий параметров я и так понимаю что за значение передается. А xml-комменты закрывают пол экрана. Некоторые любят на целый экран писать. Ну мешает же...
Выход -- xml-комменты должны быть в отдельных xml-файлах, но чтобы не было соблазна их не писать, окошко для написания комментов должно быть все время под рукой. Для этого разделяем окно редактора на 2 части (ессестно, можно мышкой менять ширину фрейма или вообще закрыть) и во второй части пишем комменты. Притом там можно автоматом генерить поля для каждого метода: для общего описания, параметров, возращаемого значения и пр.
Если вы работаете с кодом -- комменты вам постоянно не нужны -- вы и так помните все. А если нужно писать комменты -- просто растягиваете левое окошко и в авто-сгенеренном шаблоне все пишите.
Хотите?