Enlight pathways for new contributors

[Totktonada]

When I search for "python contribution guide" google land me to https://devguide.python.org/ , where different contribution activities are described:

---

---

It seems our contribution guides are much less clear for a potential new contributor.

It is the topic to investigation. Say, the documentation team may start with a guide how to contribute to the documentation :)

@tsafin may want to give more thoughts on the topic.

[Totktonada]

The idea comes from @tsafin's talk within the team, so give all credits to him.

[artur-barsegyan]

The idea with the table seems convenient for users' navigation.

Our current guide doesn't contain any navigation table and text for newcomers.

I have written the first draft of this guide with the navigation table. Please see it here.
Waiting for feedback :)

[artur-barsegyan]

The Navigation table was declined by @knazarov because:

• Markdown tables at Github are horrible
• Tables aren't appropriate format for our purpose. They are convenient for feature comparisons and for column-similar data.

[Totktonada]

Markdown tables at Github are horrible

I use it from time to time, but I don't remember any problem (for example, here, here, here, here). Can you clarify, please?

Tables aren't appropriate format for our purpose. They are convenient for feature comparisons and for column-similar data.

It is debatable, but personally I don't have strict preference here (at least for now).

[artur-barsegyan]

Hmm, actually tables look OK. But the second bullet is more important — political decision.

[Totktonada]

Re tables: I remember I had some problems with wrapping in a non-last column, but either I'm wrong here or it has been fixed.

Example

x	y	z
Markdown tables at Github are NOT horrible, Markdown tables at Github are NOT horrible, Markdown tables at Github are NOT horrible	Markdown tables at Github are NOT horrible, Markdown tables at Github are NOT horrible, Markdown tables at Github are NOT horrible	Markdown tables at Github are NOT horrible, Markdown tables at Github are NOT horrible, Markdown tables at Github are NOT horrible

[artur-barsegyan]

Seems like, we choose another way to highlight pathways. Can I close it @Totktonada ?

[Totktonada]

I would not call it 'another way', but rather another formatting and wording: the idea about routing users to relevant guides still remains. Anyway, let's manage issues as it is convenient for you.