feat: Update colon usage guidelines in style guide

Martin Chrástekrequested to merge
colons-styleguide-update into main

This MR updates the style guide rules for using colons in translations. The main updates are:

  1. Clearer guidance: Instead of avoiding colons unless they're in code, the new rule says to use colons in translations when they appear in the original English text.

  2. Simplified formatting: The spacing rules are now integrated into the main instruction rather than being a separate section, making it easier to follow.

  3. Better examples: The usage examples were updated to be more practical and consistent, showing real GitLab-related content instead of generic examples. The code example was removed as the text inside of code blocks is not translatable.

Based on this request: docs-site-localization#96 (comment 3022576744)

Edited by Martin Chrástek

Merge request reports