Update the README post?

Could we update the formatting post?

1. Bad keyboard advice

The README gives bad mac keyboard advice.

Currently:

Highlight your code. Press Ctrl+o (or Mac equivalent).

That is misleading, because it is the same on both systems. Normally when you say "Mac equivalent" that means APPLE+o. But that is bad advice -- it launches a browser file-open dialog.

Should be:

Highlight your code. Press Ctrl+o.

2. Doesn't point out editing

Many newcomers don't realize posts are editable at all! They repost new code below their old broken code. In many views the edit icon is a rollover and is hidden in the current forum software.

Should be:

Edit your post with "gear" icon. Highlight your code. Press Ctrl+o. Save.

3. Links go to the wrong place

Both clicks and pasted links to that sticky always go to "#latest" -- which is never what we want newcomers to look at first, and makes it harder for newcomers to see the advice being given to them.

Combining the three separate posts in README: How to Format Code and Text into one post would fix simplify.

Answers

Sign In or Register to comment.