Enhancing the contributing.md document

[real-slim-chadi]

Hello guys,

Here is my first PR. I am happy to work on better documentation for contributors!

Better Documentation=Easier Development

I have a couple of suggestions

Suggestions:

Add a td;lr on each link

- So that the new participant doesn't feel intimidated by the sheer amount of reading to do

Add a "to reach out" section

- with added contact info (if a contributor prefers a different messaging channel together with GitHub)

---

Here are some of my comments (having a fresh eye)

Comments

Community guidelines:

Jupyter Guidelines link is broken

• We can directly link to IPython Guidelines
  • This way, the new person has one link to click

Current developer information

• Give a more descriptive title
  • Example: "ipywidgets: what it is"

Developer install information

• steps are clear, concise and precise
• Put the setup and [troubleshooting, updating] in the Main contribute file
  • "For more info refer to the guidelines"
  • testing contributions is in the install information

release procedures

• put the Header 2s as a td;lr

testing

• Concise
• put Header 2s as td;lr

Documentation

• Also, Concise
• put Header 2's as td'lr

[github-actions]

👈 Launch a binder notebook on branch real-slim-chadi/ipywidgets/contributing

[ohrely]

@ibdafna can you please approve the workflows? @real-slim-chadi and I aren't permissioned for it.

[ibdafna]

Would it be possible to remove this line (6)?

[ibdafna]

Suggested change

	Now that we went through the basics, Here are more detailed documentation on areas of contribution:
	Now that we went through the basics, here is more detailed documentation on areas of contribution:

[ibdafna]

@real-slim-chadi many thanks for the contribution! 😸