Skip to content

Add a document describing how p4a interacts with pip & python packages#1931

Merged
1 commit merged into
developfrom
unknown repository
Jul 27, 2019
Merged

Add a document describing how p4a interacts with pip & python packages#1931
1 commit merged into
developfrom
unknown repository

Conversation

@ghost

@ghost ghost commented Jul 25, 2019

Copy link
Copy Markdown

This pull request adds an internal documentation (not build as part of user docs, I just put it in there so we can find it again - it's mainly meant to just sit around in a place where we can find it) describing how p4a interacts with pip & python packages. This is mainly meant for pip developers and others outside of our team to be able to get an idea what we're doing, although of course it could also be interesting to newcomers to our own team!

Please have fun reading and tell me if anything doesn't make sense!

inclement
inclement previously approved these changes Jul 26, 2019

@inclement inclement left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks quite complete to me, nice.

Although I would add full stops in a lot of places :<

Comment thread doc/internal-dev-info/how-pi4a-uses-pip.md Outdated
@inclement

Copy link
Copy Markdown
Member

Oh, and as for where this goes, I don't think it would be inappropriate to put it in the documentation. It could be e.g. a subpage of "Development and Contributing". I don't think that would cause issues, and it would be nice to have it be discoverable and easily referenceable in the compiled documentation.

@ghost

ghost commented Jul 26, 2019

Copy link
Copy Markdown
Author

@inclement good point! I added it into the "Development and Contributing" section now. will also make it easier to link once it's out on read the docs

Comment thread doc/source/contribute.rst Outdated
Comment thread doc/source/contribute.rst
AndreMiras
AndreMiras previously approved these changes Jul 27, 2019

@AndreMiras AndreMiras left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This documentation is a good addition, thanks.
I only saw a minor typo and also the missing full stops also bugged me 😄
In general what p4a is doing with the recipes reminds me what Gentoo (source distribution) is doing with Ebuilds. Ebuild basically has the same features, dependencies management, patching, build tools...

@AndreMiras AndreMiras left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@ghost ghost merged commit 8cf23aa into kivy:develop Jul 27, 2019
@ghost ghost deleted the packaging-dev-doc branch July 28, 2019 15:06
This pull request was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants