I'd put the pros and cons right up front on the README.

Selling the positives for a new programming languages should go hand in hand with a realistic thorough analysis of the negatives.

Negatives of the language as a brief point 18 on the tutorial makes the negatives look hidden.

▲

malkia 3 hours ago | parent [-]

He is not "selling" anything. I don't see a price, quite the opposite - it's on the user to evaluate it's points, not on the "seller" (that he is not). Obviously if this becomes paid, or paid through support product this would be one of the first points of the table - "what are the limitations, what should we be aware of sorts".

	▲	wewewedxfgdf an hour ago \| parent [-]
		Of course he's selling. Almost every word on the front page readme is a features and benefits sales pitch. But, as all good salespeople do, they focus on the positive and leave the negative in the fine print. Selling happens everywhere all the time without price.