Skip to content

Conversation

@AdamJMiles
Copy link
Contributor

This link needs to jump to the right section of the linked page, not the top.

This link needs to jump to the right section of the linked page, not the top.
@PRMerger18
Copy link

@AdamJMiles : Thanks for your contribution! The author(s) have been notified to review your proposed change.

There are many cases in the current docs that don't ahere to them, but here are some guidelines to be aware of:

- Omit language tags (for example, en-us, or en-gb) from urls.
- If possible, 
- If possible, use markdown in markdown files. The only place I know of where you can't use markdown is in the description of an enum constant within a Win32 file. Also, `—` is the only way I know to insert an emdash in markdown. Apart from that, markdown should work.
- Use sentence case in titles (rather than title case)
- In general, prefer informal contractions (for example "doesn't" rather than "does not").
@stevewhims
Copy link
Member

stevewhims commented Feb 10, 2020

Looks good, thank you! :)

Btw, there are many cases in the current docs that don't ahere to them, but here are some guidelines to be aware of:

  • Omit language tags (for example, en-us, or en-gb) from urls.
  • If possible, use site-relative links (for example "/windows/win32..." rather than "https://docs.microsoft.com/windows/win32...").
  • If possible, use markdown in markdown files. The only place I know of where you can't use markdown is in the description of an enum constant within a Win32 file. Also, — is the only way I know to insert an emdash in markdown. Apart from that, markdown should work.
  • Use sentence case in titles (rather than title case)
  • In general, prefer informal contractions (for example "doesn't" rather than "does not").

@stevewhims stevewhims merged commit 05cbee2 into MicrosoftDocs:docs Feb 10, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants