Участник:Shersh/Оформление

Основные правила написаны здесь и здесь.

Далее приводится дополнительный список требований (что подразумевается, явно не написано, всякие уточнения, красивости, сборка из правил оформления других участников) который поможет сделать вики-конспекты красивее, лучше, понятнее.

Tex

• Переменные и константы в тексте оборачивать в tex
  • [math] x, ~y, ~1 [/math] (сравни x, y, 1)
• Классы чисел оборачивать в \mathbb
  • Натуральные числа [math] \mathbb{N} [/math] (сравни [math] N [/math])
• Классы и функции оборачивать в \mathrm
  • Класс регулярных языков [math] \mathrm{REG} [/math] (сравни [math] REG [/math])
• Вместо \mod использовать \bmod, когда применяется как бинарная операция
  • [math] x \bmod y [/math] (сравни [math] x \mod y [/math])
• Вместо \le и \ge использовать \leqslant и \geqslant (сравни [math] \le \ge [/math] и [math] \leqslant \geqslant [/math])
• Для сдвигов (арифметических и нет) использовать \ll, \gg, \lll, \ggg вместо << и >> (сравни [math] \lt \lt ~ \gt \gt ~ \gt \gt \gt [/math] и [math] \ll \gg ~ \ggg [/math])
• Хинт: можно использовать \to вместо \rightarrow (\from нет, к сожалению):
• Использовать \mid вместо | в описании множеств. Теховский выделяется пробелами [math] \Rightarrow [/math] смотрится эстетичней. Касается не только этого символа, а вообще.
  • [math] \{ x \mid x \in B \} [/math] (сравни [math] \{ x | x \in B \} [/math])
• Запятые в дробях брать в {}, чтобы не было лишних пробелов
  • [math] 2{,}78 [/math] (сравни [math] 2,78 [/math])

Псевдокод

• Дополнение к концепции Python-style (надо понимать, что фигурные скобки, лишние круглые скобки, двоеточия после условий и многое другое — всё сделано для того, чтобы написать компилятор было проще, а программы компилировались быстрей, поэтому в псевдокоде надо стараться избегать всяких особенностей конкретного языка программирования, чтобы повысить читаемость кода)
  • Операторы, ключевые слова, название самой глобальной функции оборачивать в тройные кавычки (for, if, return, and, pushFront и другие)
  • Использовать словесное обозначение логических операций (and, or, xor, not вместо &&, ||, !)
    • Вместо побитового xor-а ^ (крышечка) лучше писать [math] \bigoplus [/math] (ниже о том, зачем это нужно)
    • Вместо [math] \in [/math] лучше писать in.
    • Можно не как в python — not element in set, — а переставить операнды для повышения читаемости: element not in set
    • Проверку типов и приведение к типу(если вдруг понадобится) писать как is и as
  • new _НЕ_ писать при создании экземпляра класса
  • TODO: что-нибудь разумное про enum, типа выделять его курсивом
• Случаи использования tex в псевдокоде:
  • [math] \varnothing, \emptyset [/math] вместо null
  • [math] \neq [/math] вместо !=
  • [math] \langle, \rangle[/math] и другие виды скобок, если возвращается в функции какой-то сложный объект (например объект [math] \mathrm{Pair} [/math])
  • Теоретико-множественные операции: [math] \cap \cup \subset \subseteq \triangle \setminus[/math]
  • Возведение в псевдокоде не писать через ^ (путается с xor). Лучше использовать ** или tex.