Inclusivity Issues for new contributors

[Aseem Prashar <prashara-e/prDBdGCFNcusGGlJDZ6w@public.gmane.org>]

[-- Attachment #1.1: Type: text/plain, Size: 1774 bytes --]

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 am opening this discussion thread to facilitate conversation on 
inclusivity within the Pandoc project. 

*Issue 1:* Our cognitive walk-through found that contributing to Pandoc 
page (https://github.com/jgm/pandoc/blob/master/CONTRIBUTING.md) doesn’t 
give enough information
on how to set up the environment and start contributing to people who are 
new to open source to encourage them to contribute to this project.

*Issue 2:* The documentation should also provide more instructions on 
setting up the test environment as most people contributing to open source 
for the first time will not be familiar with
the testing methods used. The documentation on what kind of test is done 
and how to test new features should also be included.

*Issue 3: *This tool is mainly for front end developers, but it has been 
implemented as a command line program, making a GUI for the tool will make 
using this tool easier and faster.

Thank you for reading, looking forward to your responses.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/7231afe1-fd0a-4e7d-93ce-fadb9030a244%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 2324 bytes --]