> Here's an example of what I was meaning (please excuse the fact that I
> know nearly nothing about restructured text, and completely nothing
> about Sphinx...):
> https://github.com/pfmoore/python-packaging-user-guide/tree/quickstart
well, ok, if we keep it really tight (like 2 pages or less),
On 16 January 2014 18:39, Marcus Smith wrote:
> given my previous arguments, if we have a "Quickstart", I would just have it
> contain links to the pip & setuptools quickstarts (and wheel too I guess).
Yeah... Although I question the value of setting up a chain of 3 links
to get someone to a pip
>
>
> That makes sense. But I think it's a case of getting people to what
> they need as quickly as possible (and having the details available
> further on, if they need them). The pip documentation is great for
> this. Go to the front page, first thing you see is "Quickstart". First
> thing that h
On 16 January 2014 17:46, Marcus Smith wrote:
>>
>> I don't have a clear picture of the split myself but it seems to me
>> that docs.python.org should be the master reference data for
>> *distutils*. That's somewhat screwed, though, as we're recommending
>> use of setuptools, and setuptools messes
>
>
> docs.python.org should provide a distutils reference, and drop the
> "Installing/Distributing Python Modules" guides in deference to the PUG.
>
to be clearer, the 2 "* Python Modules" guides have some good content, but
I think it needs to be pushed into the distutils reference, not presente
ok, let's do distutils-sig.
true, it is a pypa project, but non-pypa people are already in this
thread, and I imagine all pypa-dev people are on distutils-sig.
On Thu, Jan 16, 2014 at 9:49 AM, Carl Meyer wrote:
> Could we stop cross-posting this thread to both pypa-dev and
> distutils-sig? See
Could we stop cross-posting this thread to both pypa-dev and
distutils-sig? Seems like it belongs on pypa-dev to me, but I don't
really care so long as it isn't cross-posted to both :-)
Carl
___
Distutils-SIG maillist - Distutils-SIG@python.org
https:/
On 16 January 2014 17:24, Marcus Smith wrote:
>> On that note, the PUG index currently feels a little overwhelming
>
> The main index is 2 levels deep currently. Let me drop it to one level and
> see how that looks.
> I personally like a deep index as my main entry point to docs, but I can see
>
>
>
> I don't have a clear picture of the split myself but it seems to me
> that docs.python.org should be the master reference data for
> *distutils*. That's somewhat screwed, though, as we're recommending
> use of setuptools, and setuptools messes round so invasively with
> distutils that the use
>
>
> On that note, the PUG index currently feels a little overwhelming
The main index is 2 levels deep currently. Let me drop it to one level and
see how that looks.
I personally like a deep index as my main entry point to docs, but I can
see it being a bit much.
> the point of view of someo
Like you said, it's more elaborate than you might expect at first, but all
the comments make it very clear.
I like it.
On Thu, Jan 16, 2014 at 7:14 AM, Paul Moore wrote:
> On 16 January 2014 15:02, Marcus Smith wrote:
> >>
> >> I still think that the best resource available would be a basic "be
On 16 January 2014 15:14, Paul Moore wrote:
> I'm happy to do that, if people think it's sufficiently representative
> of "best practice" (and if they don't, they can always improve it :-))
Done.
___
Distutils-SIG maillist - Distutils-SIG@python.org
h
On 16 January 2014 15:02, Marcus Smith wrote:
>>
>> I still think that the best resource available would be a basic "best
>> practice" project template for a simple pure-python package with a few
>> tests. I started putting one together myself
>> (https://github.com/pfmoore/sampleproject). It's ba
>
>
> I still think that the best resource available would be a basic "best
> practice" project template for a simple pure-python package with a few
> tests. I started putting one together myself
> (https://github.com/pfmoore/sampleproject). It's basically done, but
> I'm not sure how it (or someth
On Thu, Jan 16, 2014 at 09:20:43AM -0500, Daniel Holth wrote:
> Has anyone ever written a setup.py that was *not* copy-and-pasted from
> somewhere else?
Presumably the 1st setup.py had to have been written by hand somehow.
Marius Gedminas
--
Five words to strike fear into the heart of any softwa
Has anyone ever written a setup.py that was *not* copy-and-pasted from
somewhere else?
On Thu, Jan 16, 2014 at 5:17 AM, Paul Moore wrote:
> On 16 January 2014 09:40, Nick Coghlan wrote:
>> Audrey Roy's "cookiecutter" project is just such a tool (although her
>> default config is far from minimal
On Jan 16, 2014, at 9:20 AM, Daniel Holth wrote:
> Has anyone ever written a setup.py that was *not* copy-and-pasted from
> somewhere else?
>
> On Thu, Jan 16, 2014 at 5:17 AM, Paul Moore wrote:
>> On 16 January 2014 09:40, Nick Coghlan wrote:
>>> Audrey Roy's "cookiecutter" project is just s
On 16 January 2014 09:40, Nick Coghlan wrote:
> Audrey Roy's "cookiecutter" project is just such a tool (although her
> default config is far from minimal - setup.py, GitHub, ReadTheDocs, tox,
> Travis, documentation skeleton, etc. It's all reasonable recommendations,
> though)
Agreed, I was poin
On 16 Jan 2014 18:08, "Paul Moore" wrote:
>
> On 16 January 2014 01:25, Chris Jerdonek wrote:
> > Is there a description somewhere of the plan for what
> > packaging-related information will be covered in docs.python.org
> > proper (and the stages for getting there), and which information will
>
On 16 January 2014 01:25, Chris Jerdonek wrote:
> Is there a description somewhere of the plan for what
> packaging-related information will be covered in docs.python.org
> proper (and the stages for getting there), and which information will
> be off-loaded to the documentation for the other proj
>
> PPUG. Also by the way, is that the right acronym for quick reference? :)
>
I guess so, or maybe "PUG". It's not pretty though.
(btw, HHGTP was the acronym for the older "Hitchhiker's Guide to Packaging")
> which information will
> be off-loaded to the documentation for the other projects
On Wed, Jan 15, 2014 at 1:30 AM, Nick Coghlan wrote:
>
> On 15 Jan 2014 17:15, "Marcus Smith" wrote:
>>
>> Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.
>>
>> The new project home is here:
>> https://github.com/pypa/python-packaging-user-guide
>> and the built site is
>
>
> > As stated in the README, "The guide is part of a larger effort to
> improve all of the packaging and installation docs, including pip,
> setuptools, virtualenv, and wheel. Ultimately, users need more than a
> "guide" to feel confident about the current tools. They need complete,
> accurate
On 16 Jan 2014 05:30, "Vinay Sajip" wrote:
>
> > fair question. partly due to personal comfort level with git/github,
but also was
> > hoping we'd get more involvement using github, since it's more popular.
>
> Your choice, of course, and I understand about the personal preference
part. I do
> won
It's not just part of a joint PSU / PYPA plan to go "full Rackspace"? :-)
On Wed, Jan 15, 2014 at 2:53 PM, Donald Stufft wrote:
>
> On Jan 15, 2014, at 2:27 PM, Vinay Sajip wrote:
>
>>> fair question. partly due to personal comfort level with git/github, but
>>> also was
>>> hoping we'd get mor
On Jan 15, 2014, at 2:27 PM, Vinay Sajip wrote:
>> fair question. partly due to personal comfort level with git/github, but
>> also was
>> hoping we'd get more involvement using github, since it's more popular.
>
> Your choice, of course, and I understand about the personal preference part.
>
> fair question. partly due to personal comfort level with git/github, but also
> was
> hoping we'd get more involvement using github, since it's more popular.
Your choice, of course, and I understand about the personal preference part. I
do
wonder how much involvement you will get from people
fair question. partly due to personal comfort level with git/github, but
also was hoping we'd get more involvement using github, since it's more
popular.
On Wed, Jan 15, 2014 at 8:18 AM, Tshepang Lekhonkhobe wrote:
> On Wed, Jan 15, 2014 at 9:14 AM, Marcus Smith wrote:
> > Fyi, the "Python Pa
On Wed, Jan 15, 2014 at 9:14 AM, Marcus Smith wrote:
> Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.
Why the move?
___
Distutils-SIG maillist - Distutils-SIG@python.org
https://mail.python.org/mailman/listinfo/distutils-si
On 15 Jan 2014 17:15, "Marcus Smith" wrote:
>
> Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.
>
> The new project home is here:
https://github.com/pypa/python-packaging-user-guide
> and the built site is still here:
https://python-packaging-user-guide.readthedocs.org/e
Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.
The new project home is here:
https://github.com/pypa/python-packaging-user-guide
and the built site is still here:
https://python-packaging-user-guide.readthedocs.org/en/latest/
For those who are interested in helping, a
On 3 July 2013 09:18, Alex Burke wrote:
> Hi Marcus,
>
> I would very much like to get involved and help with this effort - in fact
> I was looking to package up some of my own work recently and stumbled on
> The Hitchhiker’s Guide to Packaging but could tell some of the advice was
> out of date
On Tue, Jul 2, 2013 at 7:18 PM, Alex Burke wrote:
> Hi Marcus,
>
> I would very much like to get involved and help with this effort - in fact I
> was looking to package up some of my own work recently and stumbled on The
> Hitchhiker’s Guide to Packaging but could tell some of the advice was out
Hi Marcus,
I would very much like to get involved and help with this effort - in fact I
was looking to package up some of my own work recently and stumbled on The
Hitchhiker’s Guide to Packaging but could tell some of the advice was out of
date having followed the discussions for a while now.
Everyone:
Soon after pycon, the "The Hitchhiker’s Guide to Packaging" (HHGTP) was
forked into the "Python Packaging User Guide".
src: https://bitbucket.org/pypa/python-packaging-user-guide
built: https://python-packaging-user-guide.readthedocs.org/en/latest/
Here's the original discussion on dis
35 matches
Mail list logo