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