context-examples icon indicating copy to clipboard operation
context-examples copied to clipboard

This is awesome, but I still think the ConTeXt documentation needs improvement

Open joanimato opened this issue 6 years ago • 1 comments

Great job. This is a great collection and certainly makes things easier, but I still think that ConTeXt documentation is a mess, especially for beginners. After browsing the documentation for hours, I have yet to successfully install/use ConTeXt outside of a TeXLive distribution, and I still have no idea how fonts are supposed to work. I don't think the documentation makes those things easy to understand, and I would really like to see that improve on an official capacity (that includes fixing their website, which for now does nothing but add to the confusion).

In addition to documentation that is up-to-date, clear, easy to reference, and free of contradictions (which the current ConTeXt website is NOT), there needs to be a solid, idiot proof, and step by step tutorial on ConTeXt targeted to beginners. There's no official document to that effect, and the "creating presentation in 40 commits" doesn't really accomplish that. It's outdated, and I got an error in the 5th or 6th commit.

So that -- an easy to use tutorial for beginners, and a polished website -- would do wonders in attracting new users in and making the platform easier to use.

joanimato avatar Oct 15 '18 18:10 joanimato

@joanimato Your other points are well taken. I have updated the creating presentation in 40 commits repo, so hopefully, the error should no longer be there.

adityam avatar May 11 '20 17:05 adityam