Skip to content
New issue

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

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

Already on GitHub? # to your account

Decide on changes to Github page(s)... #73

Open
chalmerlowe opened this issue May 13, 2017 · 4 comments
Open

Decide on changes to Github page(s)... #73

chalmerlowe opened this issue May 13, 2017 · 4 comments

Comments

@chalmerlowe
Copy link
Owner

Right now, the table of contents has two links on the overhaul branch related to github, that need some work:

https://github.com/chalmerlowe/intro_to_sprinting/blob/overhaul/class_materials/github_setup.md
https://github.com/chalmerlowe/intro_to_sprinting/blob/overhaul/class_materials/fork_a_repo.md

Right now, the github setup page has the content needed in the fork_a_repo page.

ACTION: decide on whether we need two pages OR not.
IF yes, then migrate the right materials to each page.

feel free to discuss here.

@steve-lorenz
Copy link
Contributor

@chalmerlowe I think this depends if the 'fork page' will talk about syncing a fork. If this is out of the scope of this tutorial, then I would say it should be on a single page.

@chalmerlowe
Copy link
Owner Author

chalmerlowe commented May 13, 2017

@Lorenz21 the benefit to having it on two pages is that the table of contents (TOC) will allow folks to get closer to their end goal faster, if they need a quick refresher on how to fork a repo.
it is not inherently obvious just looking at the TOC that github setup is OR should include steps on fork a repo.

@chalmerlowe
Copy link
Owner Author

I looked at the setting up github page in the tutorial.
if we separate out the content into two pages...

  • setting up github
  • forking a repo

both pages will be short, but will clearly point to what can be expected on that page.
@seawolf42 do you have any thoughts on this?

@chalmerlowe chalmerlowe modified the milestones: 2017 Pycon, pycon 2019 Apr 13, 2019
@seawolf42
Copy link
Collaborator

@chalmerlowe I think that's a great idea... also bumps the time down to about 5m each, and in this case the actual step should be something people can do with little variance in how long it takes.

# for free to join this conversation on GitHub. Already have an account? # to comment
Projects
None yet
Development

No branches or pull requests

3 participants