CONTRIBUTING: add "Getting familiar with the project"

Following [today's discussion on Zulip](https://xi.zulipchat.com/#narrow/stream/149610-pulldown-cmark).
pull/1/head
ngirard 5 years ago committed by GitHub
parent b943c036a9
commit e2de243665
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -1,11 +1,21 @@
Want to contribute? Great! First, read this page.
### Before you contribute
Before you start working on a larger contribution, you should get in touch with
us first through the issue tracker with your idea so that we can help out and
possibly guide you. Coordinating up front makes it much easier to avoid
frustration later on.
### Getting familiar with the project
**The architecture** is somewhat unique, it was originally inspired by [XML pull parsers](http://www.xmlpull.org), but ended up going in somewhat its own direction. to get familiar with it,
- start my reading the [README](README.md) page, which gives some details on the design of the parser (pull-based events) and some rationalization for it ;
- read the [blog post](https://fullyfaithful.eu/pulldown-cmark) about the release of Pulldown-cmark 0.3 by Marcus Klaas de Vries.
**The source code** can be approached by skimming the [API documentation](https://docs.rs/pulldown-cmark/latest/pulldown_cmark) first, then explore the code for the main struct, [`Parser`](https://docs.rs/pulldown-cmark/latest/pulldown_cmark/struct.Parser.html)
### Code reviews
All submissions, including submissions by project members, require review. We
use GitHub pull requests for this purpose.

Loading…
Cancel
Save