Added some explanations for various crates.

[Narfinger]

Signed-off-by: Narfinger [email protected]

[Narfinger]

I am wondering if we should add some formulation to the distinction it makes. In some sense something like:

• Working on servo only crates is easy.
• Working on mozilla crates needs special mozilla workflow
• Working on crates that other people use needs extra care for api stability and other use cases.
  But I am not quite happy with such a formulation. Any ideas?

[mrobinson]

This list is pretty similar to what is in https://book.servo.org/design-documentation/directory-structure.html. Can you please integrate it into that page and rename it to "Project Structure?" Thank you.

[mrobinson]

This is getting there. One thing: after every colon decide if you want to capitalize the first letter of the phrase or not. I would say don't do it, but above all be consistent.

[Narfinger]

Thanks for the suggestion! I hope I got all of them.
One thing that I feel is still missing is something like this:
Original my reason for making this list was to show which crates people need to be more careful about updating and which parts can be a bit looser. But I don't quite know how to formulate that in a good sentence.

[Narfinger]

@mrobinson any update on this?

[jdm]

I think the current framing is an improvement over what's on the page right now, so we should merge it.