CommonMark tutorial / help page feedback
@codinghorror wrote: Ok @Crissov all the major stuff you brought up has been addressed: show generated html is an overlay that replaces the HTML output success alert is no longer a modal dialog...
View ArticleCommonMark tutorial / help page feedback
@mb21 wrote: I guess it would be nice to have a preview as well when you introduce a new concept in the tutorial. I mean a preview of what the markdown (with the red dots hanging around) looks like...
View ArticleClik here to view.
CommonMark tutorial / help page feedback
@codinghorror wrote: I have been through about 8 cycles of public feedback on the tutorial, with many iterative improvements, so I am comfortable it is in a good place to link prominently from...
View ArticleCommonMark tutorial / help page feedback
@codinghorror wrote: Ok http://commonmark.org has been updated (slightly) and has direct links to http://commonmark.org/help on it.. Read full topic
View ArticleCommonMark tutorial / help page feedback
@Dmitry wrote: http://commonmark.org/tutorial is broken. Read full topic
View ArticleClik here to view.
CommonMark tutorial / help page feedback
@codinghorror wrote: Hmm yeah, looks like it works on the live site though. So I'll just delete that link from above. oh duh, it's supposed to be http://commonmark.org/help/tutorial/ my bad Read full...
View ArticleClik here to view.
CommonMark tutorial / help page feedback
@codinghorror wrote: Crissov: Please use proper, typographic, curly apostrophes and quotation marks. Thank you. OK, I think I “got” them all, but y’all will have to “check” my work. Read full topic
View ArticleCommonMark tutorial / help page feedback
@loseth wrote: I would argue against using a.com and b.org, and a.png and b.jpg for links and image links. It is not logical to say that the two expressions gives the same result with different urls,...
View ArticleCommonMark tutorial / help page feedback
@erlend_sh wrote: You need a way to distinguish between the two links, or else newcomers might think that the entire 3-liner is all one link, with an awfully complicated syntax. I wouldn't mind the...
View ArticleCommonMark tutorial / help page feedback
@loseth wrote: I think the page is great as it is, and that the OR is quite visible to separate the alternatives.I see your point, but I think that someone who would think that the the two...
View ArticleCommonMark tutorial / help page feedback
@tin-pot wrote: What a nice and stylish tutorial! One small suggestion (first "notch" in "05 Links"): The blurb about reference-style link definitions says: The link definition can be placed anywhere...
View ArticleCommonMark tutorial / help page feedback
@codinghorror wrote: Sure that seems like a nice clarification, will add. Also: added some missing fancy quotes to success messages converted wikipedia hurricane link to goo.gl shortened link for ease...
View ArticleCommonMark tutorial / help page feedback
@borekb wrote: Have nested lists been discussed? I see them very often and would expect them to be mentioned on the /help page. Read full topic
View ArticleCommonMark tutorial / help page feedback
@codinghorror wrote: Yes, that is covered at some length in the tutorial, please try it. Read full topic
View ArticleCommonMark tutorial / help page feedback
@borekb wrote: Oh I missed that in the tutorial, was expecting a mention of nested lists on the main /help page. BTW are nested list part of the specification at all? Found some philosophical...
View ArticleCommonMark tutorial / help page feedback
@jgm wrote: Nested lists are covered, yes. Lists are block-level elements, so nested lists are just a special case of the nesting of block-level elements under list items.You'll find specific...
View ArticleCommonMark tutorial / help page feedback
@borekb wrote: Are four spaces recommended for simple nested lists or does CommonMark have no "opinion" here? Read full topic
View ArticleCommonMark tutorial / help page feedback
@jgm wrote: CommonMark has a more flexible treatment of nested lists than the "four-space rule." (See the spec for a discussion.) However, the tutorial recommends four spaces indentation, because this...
View ArticleCommonMark tutorial / help page feedback
@borekb wrote: Thought so, thanks for confirming it. I still think nested lists should me mentioned on the main /help page as it's quite a common use case. Read full topic
View ArticleClik here to view.
CommonMark tutorial / help page feedback
@erlend_sh wrote: For /help/, instead of displaying all available syntax options all at once, could we add a basic tab toggle instead? commonmark-help.jpg2048x1352 122 KB I like how the middle row is...
View ArticleCommonMark tutorial / help page feedback
@codinghorror wrote: I don't find the two columns to be overwhelming; this is the first time I've ever heard that bit of feedback from anyone.. and I have asked in a lot of places for feedback on...
View ArticleCommonMark tutorial / help page feedback
@Crissov wrote: I don’t know whom and how you asked, but if you could do actual user tests it may well be that you discovered that @erlend_sh has a valid point. I’m not sure, though. Anyway, it‘s...
View ArticleCommonMark tutorial / help page feedback
@leotsarev wrote: Hi everyone! I have an question about http://commonmark.org/help/What's the policy of translation of this page?I'll be happy to contribute russian-translated version of this page if...
View ArticleCommonMark tutorial / help page feedback
@codinghorror wrote: For the main page, a translation is OK! It is static HTML. For the 10 minute tutorial, we need to come up with a JS translation framework approach. Which is a lot more work. Read...
View ArticleCommonMark tutorial / help page feedback
@leotsarev wrote: To clarify:I have an approval to work on it? Read full topic
View Article