Hi everyone!
Oregon State University's Free/Open Source Software class has us evaluate real-world open-source projects for inclusivity using a cognitive walk-through technique.
I'm opening this discussion post to facilitate conversation on inclusivity within the Pandoc project. Our cognitive walk-through found that the installer page (
https://github.com/jgm/pandoc/blob/2.7.2/INSTALL.md) had jargon and assumed advanced knowledge that was not inclusive of the persona which was the subject of our evaluation. See, for example, instructions on installing using Chocolatey, Homebrew that are limited to "install pandoc using Chocolatey/Homebrew." There are links provided to these respective tools, but our walk-through found that it is likely that a new person looking to get involved would be more likely to be discouraged rather than dive into finding out more about Chocolatey/Homebrew. The LaTex setup instructions could also be a bit more detailed.
Thank you for reading, and look forward to hearing what you all have to say about possible ways to improve the project's accessibility!