Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[tracking] new tutorials and other revisions #194

Open
ddbeck opened this issue Dec 3, 2015 · 21 comments
Open

[tracking] new tutorials and other revisions #194

ddbeck opened this issue Dec 3, 2015 · 21 comments
Labels

Comments

@ddbeck
Copy link
Contributor

@ddbeck ddbeck commented Dec 3, 2015

This issue is to track work on writing new, introductory tutorials for the guide, and other activities that are part of an effort to expand and revise the guide. See this thread from the distutils-sig for more details about this project. Work on these tutorials will (at least initially) take place on the develop branch.

I am inviting the group of volunteers to use this issue to see what other issues are available and to use this as a place for general questions and help (i.e., questions that are not issue-specific), to minimize noise on other issues and the creation of new issues.

If you'd like to contribute to these sections, please see the (to be) linked issues for details. Additionally, please review the developing guide to contributing. If you start work on an issue, please consider saying so on the relevant issue, so others don't duplicate your work. Thanks!

Outline

Broadly, the new intro to packaging tutorials have the following outline:

  1. Who is this for?
  2. Prerequisites
  3. What's a package?
  4. Where do packages come from?
  5. Install your first package
  6. Use a virtual environment
  7. Make your first package
  8. Publish your first package

Issues will soon be created to address each section specifically; the outline above will link to each section's issue.

Bite size tasks

  • #207: Add build instructions to the README

Extra style notes

The intro to packaging tutorials have some extra style considerations on top of that of the guide generally:

  • In contrast to more task-focused writing, the tutorials are meant to build fundamental packaging skills, rather than resolve a specific problem. With that in mind, try to invite readers to learn to do something without regard for its specific applications. So instead of something like "Read this section if you want to share a package…" try "After you complete this section, you'll be able to share a package…"
@souravsingh
Copy link

@souravsingh souravsingh commented Dec 4, 2015

I would like to work on the first two parts of the tutorial.

@ddbeck
Copy link
Contributor Author

@ddbeck ddbeck commented Dec 4, 2015

@souravsingh That's great! I would suggest picking one to begin with and, as you make progress, mention that you're working on it in the section-specific issue (so others don't duplicate your work). Let me know if you have any questions. Thanks!

@thatdocslady
Copy link

@thatdocslady thatdocslady commented Dec 8, 2015

I'll be happy to help with content reviews (proofreading, editing) and overall structure, unfortunately I don't have enough bandwidth at the moment to write content from scratch :-( feel free to assign any content that needs review to me :-)

@souravsingh
Copy link

@souravsingh souravsingh commented Dec 8, 2015

Thanks for the help @thatdocslady

@alexwlchan
Copy link
Contributor

@alexwlchan alexwlchan commented Dec 8, 2015

Like thatdocslady, I'm happy to take on review tasks if it's useful, but I can't promise any original content (things are all a bit up-in-the-air at the moment).

@ddbeck
Copy link
Contributor Author

@ddbeck ddbeck commented Dec 8, 2015

@thatdocslady @alexwlchan thank you both for volunteering! As sections become stable, I'll definitely call on you to be a new set of eyes.

@dsmatlak
Copy link

@dsmatlak dsmatlak commented Dec 11, 2015

I want to learn about Python and participate in this project by either writing, researching, or proofreading. If you have any suggestions for a Python newbie, please let me know. Thanks :)

@ddbeck
Copy link
Contributor Author

@ddbeck ddbeck commented Dec 14, 2015

@dsmatlak Great, I think you're in the right place. Since you're new to Python, I think it would be a big help if you could test out the new tutorial sections as they are written. I'm also planning to work on writing up some bite-size issues that might be a little more manageable than writing a whole new section. I'm planning to tag issues soon and update here when we get to that point. Thanks for your interest!

@dsmatlak
Copy link

@dsmatlak dsmatlak commented Dec 16, 2015

@ddbeck Excellent, sounds good.

ddbeck pushed a commit that referenced this issue Feb 7, 2016
This completes the work required to merge PR #211 (corresponding to issue #202)
also included as part of issue #194.
@ddbeck ddbeck mentioned this issue Apr 5, 2016
@azibit
Copy link

@azibit azibit commented Feb 18, 2017

Woow, Just came across this issue and I would really love to be of help

@ddbeck
Copy link
Contributor Author

@ddbeck ddbeck commented Feb 18, 2017

@azibit thanks for your interest! This has fallen by the wayside a little bit, but I'll have more time to work on this project in the next couple weeks, I expect. Take a look at some of the issues linked from the outline and see if there's something specific you'd like to work on. Happy to provide any specific guidance or help, as needed.

@ghost
Copy link

@ghost ghost commented Apr 13, 2017

I'd love to contribute a bit to this. I'm doing a bootcamp and would like to practice adding to documentation and potentially some code. Thanks.

@theacodes
Copy link
Member

@theacodes theacodes commented Apr 14, 2017

@jonfujita as mentioned in @ddbeck's comment, this has fallen a bit by the wayside but if there's any particular topic you want to pursue let us know and we can provide some guidance.

@ddbeck
Copy link
Contributor Author

@ddbeck ddbeck commented Apr 14, 2017

@jonparrott Oh jeez that couple weeks thing was… optimistic. I've noticed you've brought on a lot of activity on the repo, triaging open issues and PRs. Did you have any long term plans that I can coordinate with (or at least not get in the way of), especially when it comes to these tutorials?

@theacodes
Copy link
Member

@theacodes theacodes commented Apr 14, 2017

@ddbeck still getting my head around all of this so I'm doing some baby steps (both for my own benefit and to not rustle feathers by changing everything at one). I'll let you know once I'm a bit more comfortable (and feel free to nag me).

@theacodes theacodes mentioned this issue May 26, 2017
6 of 6 tasks complete
@aryan-harsh
Copy link

@aryan-harsh aryan-harsh commented Jun 23, 2018

@ddbeck @theacodes is there any work left to do? can i help in any way. i do not know much of python, but am good with content writing.

@Venu-Gopal18
Copy link

@Venu-Gopal18 Venu-Gopal18 commented May 20, 2019

@ddbeck I am good at content writing and well aware of python . Is there anything I can do? I want to be participate as active as possible cuz I'm new

@lorarjohns
Copy link

@lorarjohns lorarjohns commented Dec 1, 2019

I'd love to contribute content on virtual environments.

I can also get into managing and deploying packages with Docker Compose; pytest and Fabric/GitHub CI/CD workflows with VSCode, and packaging vs 'developing' for different tools and different objectives, if you like. I have a teaching and research background and really enjoy making tutorials 😄

@Lawrence-Krukrubo
Copy link

@Lawrence-Krukrubo Lawrence-Krukrubo commented May 18, 2020

Hey guys, how can I contribute. I'm a top writer in Artificial intelligence in the Medium and I love to code. please let me know where I can best fit in

@ihzarizkyk
Copy link

@ihzarizkyk ihzarizkyk commented Jul 2, 2020

how to make the first package? ... because I'm very interested

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
13 participants
You can’t perform that action at this time.