Что я могу назвать людьми, которые расширяют мой класс в документации по базовому классу?

Назвал их «исполнителями», но мне это кажется странным.

/// <summary>
/// Implementers should implement this.  Derp
/// </summary>
protected abstract void InternalExecute();

Точка уточнения, мне интересно, как назвать людей , которые создают дочерние классы, а не сами дочерние классы.

«Эй, ты там« не »там.»

6 голосов | спросил Will 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 19:41:04 +0300 2010, 19:41:04

10 ответов


8

Документация класса MSDN часто использует «вы» для ссылки на разработчиков.

  

Когда вы наследуете WebRequest, вы должны переопределить следующие члены ...

     

Обычно вы не наследуете ButtonBase. Чтобы создать свой собственный класс кнопки, наследуйте класс Button, CheckBox или RadioButton ....

Вы также можете просто указать, какие требования относятся к классам потомков. Подразумевается, что разработчики - ваша аудитория.

  

Классы, наследующие IDbConnection, должны реализовывать все унаследованные элементы и обычно определять дополнительные члены, чтобы добавить специфические для поставщика функции.

В вашем примере вместо «Исполнитель должен реализовать это», напишите «Descendent classes должны переопределить InternalExecute to ...» или «В классах потомков вы должны переопределить InternalExecute to ...».

ответил Joe Daley 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 23:02:13 +0300 2010, 23:02:13
6

Я обычно говорю children, child classes или inheritors.

Это не так важно; люди поймут, что вы подразумеваете под кодом Implementers в любом случае.

ответил Nobody 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 19:45:12 +0300 2010, 19:45:12
6

Наследники? (нужно еще несколько символов)

ответил Mladen Jablanović 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 19:47:48 +0300 2010, 19:47:48
5

subclasses или classes that extend ThisInterface или ---- +: = 2 = + ----

ответил Dan Rosenstark 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 19:47:07 +0300 2010, 19:47:07
4

Вы не должны упоминать людей, которые закодировали в документе, но как базовый класс должен быть расширен, следовательно, вы могли бы назвать их «реализациями»

т

  

Этот базовый класс определяет базовую структуру бла-бла-бла. Реализации должны делать XYZ, чтобы заставить его работать.

Или

  

Реализации этого класса также должны учитывать ...

ответил OscarRyz 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 21:39:46 +0300 2010, 21:39:46
4

Вы можете называть их расширителями или подклассами.

ответил Winston Ewert 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 20:01:01 +0300 2010, 20:01:01
2

Я обычно говорю child class. Говоря о наследовании, implementers будет немного запутанным для меня, потому что это заставляет меня думать, что класс реализует интерфейс, который отличается из класса наследования.

ответил TaylorOtwell 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 20:47:02 +0300 2010, 20:47:02
2

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

Говоря, я думаю, что это вообще плохая идея ссылаться на людей, использующих ваш код в комментариях. Комментарии должны указывать, что делает код, а не то, что должен делать разработчик.

ответил AndrewC 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 21:27:28 +0300 2010, 21:27:28
1

Я хочу предложить готовое решение: давайте удалим этот комментарий в целом, а затем у нас нет проблемы с его фразой .

Ключевое слово abstract уже говорит все: один из производных классов должен реализовать этот метод. Если это намерение, которое вы хотите сообщить разработчикам этих производных классов, то вы уже используете этот конкретный языковой элемент соответствующим образом.

ответил azheglov 23 22010vEurope/Moscow11bEurope/MoscowTue, 23 Nov 2010 22:39:27 +0300 2010, 22:39:27
0

Пользователи

IE, пользователи базового класса.

ответил Dominic McDonnell 24 32010vEurope/Moscow11bEurope/MoscowWed, 24 Nov 2010 00:43:39 +0300 2010, 00:43:39

Похожие вопросы

Популярные теги

security × 330linux × 316macos × 2827 × 268performance × 244command-line × 241sql-server × 235joomla-3.x × 222java × 189c++ × 186windows × 180cisco × 168bash × 158c# × 142gmail × 139arduino-uno × 139javascript × 134ssh × 133seo × 132mysql × 132