DOC: Refactor "Python as Glue"

[HaoZeke]

Issue with current documentation:

At a recent docs meeting, it was noted that the "Python as Glue" is written in a style unlike the rest of the docs.

Note that this is not a priority, and simply a minor tracking issue.

Idea or request for content:

No response

[hassanrahim26]

Hey @HaoZeke, I'm new to this organisation and I want to contribute to this issue. Can you please tell me ways to get started.

[mattip]

The intent is to rewrite this page. The source for that is numpy/doc/source/user/c-info.python-as-glue.rst. In order to understand the workflow for changing documentation, please try out the gitpod guide and read about documentation development. Once you understand the technical details and the workflow, you need to think about the intent of the comment above: read the page and the other documentation and try to understand what is different about the style of this page, and how you can change it to match the rest of the documentation.

[hassanrahim26]

The intent is to rewrite this page. The source for that is numpy/doc/source/user/c-info.python-as-glue.rst. In order to understand the workflow for changing documentation, please try out the gitpod guide and read about documentation development. Once you understand the technical details and the workflow, you need to think about the intent of the comment above: read the page and the other documentation and try to understand what is different about the style of this page, and how you can change it to match the rest of the documentation.

@mattip, thank you so much for telling me. I'll go through the guide which you mentioned and after understanding the workflow, I'll start contributing. 😃

[Mukulikaa]

Hi @hassanrahim26, you might also find NEP 44 useful. It talks about how the documentation is supposed to be restructured. It might give you ideas on where to place "Python as a Glue" and which style to rewrite it in.

[hassanrahim26]

Hi @hassanrahim26, you might also find NEP 44 useful. It talks about how the documentation is supposed to be restructured. It might give you ideas on where to place "Python as a Glue" and which style to rewrite it in.

@Mukulikaa, thanks for telling. I'll look into it 😄

[JEMA99]

participate in the problems, it is important that they help us