Brush up CONTRIBUTING.md

This commit is contained in:
Aleksey Kladov 2018-01-28 00:34:16 +03:00
parent a4880ca03e
commit ffe545cc37

View file

@ -1,8 +1,8 @@
The project is in its early stages: contributions are welcome and
would be **very** helpful, but the project is not *yet* optimized for
contributors. Moreover, it is doubly experimental, so there's no
contribution. Moreover, it is doubly experimental, so there's no
guarantee that any work here would reach production. That said, here
are some arias where contributions would be **especially** welcome:
are some areas where contributions would be **especially** welcome:
* Designing internal data structures: RFC only outlines the
@ -11,7 +11,11 @@ are some arias where contributions would be **especially** welcome:
* Porting libsyntax parser to libsyntax2: currently libsyntax2 parses
only a tiny subset of Rust. This should be fixed by porting parsing
functions from libsyntax one by one.
functions from libsyntax one by one. Take a look at the
[libsyntax parser](https://github.com/rust-lang/rust/blob/6b99adeb11313197f409b4f7c4083c2ceca8a4fe/src/libsyntax/parse/parser.rs)
for "what to port" and at the
[Kotlin parser](https://github.com/JetBrains/kotlin/blob/4d951de616b20feca92f3e9cc9679b2de9e65195/compiler/frontend/src/org/jetbrains/kotlin/parsing/KotlinParsing.java)
for "how to port".
* Writing validators: by design, libsyntax2 is very lax about the
input. For example, the lexer happily accepts unclosed strings. The
@ -29,4 +33,7 @@ are some arias where contributions would be **especially** welcome:
Do take a look at the issue tracker, and try to read other docs in
this folder.
the [./docs] folder!
If you don't know where to start, or have *any* questions or suggestions,
don't hesitate to chat at [Gitter](https://gitter.im/libsyntax2/Lobby)!