search

MicrosoftDocs / microsoft-style-guide

Public contribution for Microsoft Style Guide
Creative Commons Attribution 4.0 International
178 stars 88 forks source link

Formatting Developer Documentation | Conflicting guidelines? #315

Open CleanCodeDeveloper opened 2 years ago

CleanCodeDeveloper commented 2 years ago

Hello, I found the page Formatting developer text elements in conflict to the code formatting section of Text formatting guidelines.

Is the first page outdated? The second page seems to suggest that it is referring the other guidelines as "old".

Why? Older style guides specify bold for many of these text elements. However, most articles are localized, and code style tells the translator to leave that part of the text untranslated.

Background: @Jay-o-Way is working to improve the Microsoft PowerToys Developer Documentation. There is an ongoing discussion which text formatting guidelines should be applied.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

Jay-o-Way commented 2 years ago

Looking at issues and prs throughout this repo, I'm thinking they lost the password to this account. There have been no serious responses since years. How is that possible?! 🤨