Skip to main content
7 из 10
Выделение фрагмента, принадлежащее автору перевода
Arhadthedev
  • 11.6k
  • 1
  • 16
  • 39

Когда стоит использовать внутристрочное выделение для кода?

Это перевод. Оригинал - тут.

Недавно я сделал небольшой обзор вопросов, которые задают пользователи и заметил, что большинство из них не пользуется внутристрочным выделением кода (например, «метод main()», или «класс HelloWorld») - другими словами, они не используют обратный апостроф (`).

Есть ли на SO страница или вопрос, на который можно отправить для объяснения, что такое выделение кода внутри строки и когда его стоит использовать (желательно с примерами).

Я нашел вопрос Inline Code Spans should not be used for emphasis, right? (Верно ли, что выделение кода внутри строки нежелательно использовать для смысловых ударений?). К нему есть хороший ответ, в котором говорится, что внутристрочное выделение следует использовать для «кода и кодообразных сущностей». Однако, тот вопрос приводит нас к другому вопросу - что такое «кодообразная сущность». Например, идентификаторы или фрагменты логов часто форматируют при помощи внутристрочного выделения, но их с трудом можно назвать «кодообразными сущностями». Можно привести и другие примеры, которые еще больше запутают дело.

Во многих изданиях по программированию имеется раздел, в котором приводится описание того, как и для чего в книге применяются то или иное форматирование текста. Есть ли на SO похожее описание относительно использования внутристрочного выделения кода?

gbg
  • 22.3k
  • 11
  • 14