<br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div class="im">On 14 July 2013 18:02, Marcus Smith <span dir="ltr"><<a href="mailto:qwcode@gmail.com" target="_blank">qwcode@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div>there's a section marked "Installation Tutorial".  Someone wanting to install packages should be able to get into that, once it actually has content  : )</div></blockquote><div><br></div></div><div>Yes, I see that. I'm not sure I like the up-front "decide between user or system or virtualenv" presentation, though. I'm working on something I prefer, see what you think when it's done. </div>
</div></div></div></blockquote><div><br></div><div>yea, don't take the current install tutorial TOC that seriously.  </div><div>The user/global/virtualenv content came from a recent merge Nick referred to above.</div>
<div>We just need knowledgeable people to get in there and start working/changing</div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra">
OK... But remember that most users are consumers of packages, not creators of them. The packaging guide should reflect that </div></div></blockquote><div> </div><div>Like Nick said, we can put the "Installation Tutorial" above the "Packaging Tutorial".   </div>
<div>Neither tutorial should be considered "Advanced" IMO.  The tutorials should be crisp and fast.</div><div><br></div><div>Also, we *could* put a "Quickstart" above both tutorials, that just lists the frequent commands with one-liner descriptions, but we have to be really careful that it doesn't end up duping the tutorials, which are also intended to be quick as well.</div>
<div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra">If not, let's just get a user-only starter page in the Python docs and leave the packaging guide as the "more comprehensive" documentation it can refer to).</div>
</div></blockquote><div><br></div><div>anything that results in feeling like the user guide needs a "user-only starter page in Python docs" means we're doing it wrong IMO  :  )</div></div><div><br></div><div>
I admit the title itself concerns me: "Python Packaging User Guide",  like it should have the word "Installation" in it.</div><div>"Python Installation and Packaging User Guide"?  (its soooo long though....)</div>
<div><br></div><div>Marcus</div></div>