John Gabriele

verbatim blocks tildes syntax supported?

15

I notice that, in addition to triple-backticks, I can get verbatim blocks with tildes as well: ~~~~~~ ~~~ works for code blocks ~~~ ~~~~~~ but it's not mentioned in the...

create cheetsheet.md

4

First draft at a cheatsheet for djot.

English words/commands in djot markup?

2

I know that, with Markdown, the rule is to only use punctuation symbols for markup; the prime directive being "optimize for readability". The markup shouldn't look like markup! Then folks...

In syntax def doc examples, show html output rendered as well

11

It would help to quickly visualize and learn what a bit of djot markup does if the examples contained rendered html in addition to the raw html output.

proposal: vertically align binding values in `let`

26

Here's a preference I have that I think might be good for the style guide: ``` clojure ;; good (let [thing "stuff" other-thing "other stuff"] ...) ;; ok (let [thing...

heading, top-level, and trailing comments

3

Re. "The only comments in which omission of a space between the semicolon and the text is acceptable are margin comments." Leaving out the space there looks bad, IMO. I...

Html to md

2

Mark, It would be very nice if the article had syntax highlighting for the code snippets. It would also be nice if it were in some format other than raw...

Unclear example

1

Near the top of the "Functions" section, it says: ``` let( [x] (+ x 1)) ``` but it's unclear to me what that means. Is there a typo there, or...

feature idea: verbose or tooltip version (using github project description)?

3

Most of the projects listed in the toolbox have a github page, and most github pages contain a "project description" line at the top. What do you think of having...

deprecation policy for Janet

20

Would a deprecation policy be useful for Janet? Does the Janet compiler currently have a mechanism for issuing deprecation warnings?