DOC: add documentation for Meson arguments

[peter-urban]

This is a draft for the (how-to) meson-args documentation. It includes an example for using meson install_tags using meson-python's install options (PR #288 and issue #68)

I could not yet answer all todos
(Mention the order in which Meson arguments are added, and how it affect Meson)
and
(Explain how you can add extra Meson arguments via the build config settings)

Feel free to comment on what you like/dislike or directly copy/modify it to you liking

[FFY00]

I have some comments, these are all kind-of nitpicks. If they are too much for you, I can definitely fix them before merging.

Regarding the pypa/build vs pip commands. We could actually use https://sphinx-design.readthedocs.io/en/latest/tabs.html instead, I think it would look better. They should probably be synchronized tabs too.

[FFY00]

Regardless, this is very much appreciated @peter-urban!

[peter-urban]

Hi @FFY00, your comments are appreciated!
I am planning to use sphinx in my own project and I am happy to learn some things about styling.

I'll check through your comments in the coming days and apply them one after the other.
(I don't think there is a rush here right?)

[peter-urban]

Ok, I had surprisingly much time tonight :-D
It's ready for another revision round.

[peter-urban]

@FFY00 ... sorry I didn't want to be pushy with the 're-review' request. I mistook the double arrow symbol next to your name as "update"

[peter-urban]

I removed the note "admonition:: All four categories must exist" because #293 was resolved in #304

[peter-urban]

Regarding the pypa/build vs pip commands. We could actually use https://sphinx-design.readthedocs.io/en/latest/tabs.html instead, I think it would look better. They should probably be synchronized tabs too.

I rewrote the examples using the sphinx-design tabs command

[FFY00]

@FFY00 ... sorry I didn't want to be pushy with the 're-review' request. I mistook the double arrow symbol next to your name as "update"

No worries at all! FYI pinging me often if something is blocked on me is actually helpful, so not bothered at all by pings.

[FFY00]

@peter-urban thank you so much! This is great!

I just have some final comments, and then we can go ahead and merge this.

Also, if you could remove the points you tackled in the PR from the todo list at the top of the page, that'd be appreciated.

[peter-urban]

I adapted your suggestions. Let me know what you think.

[FFY00]

Thanks @peter-urban, looks great!

There are just some minor fixups, but I'll apply those via Github's UI and mege 😊