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

add/link out to instructions to deploy HTML built with Sphinx #60

Open
tobyhodges opened this issue Jul 24, 2020 · 1 comment
Open

add/link out to instructions to deploy HTML built with Sphinx #60

tobyhodges opened this issue Jul 24, 2020 · 1 comment
Labels
type:discussion Discussion or feedback about the lesson

Comments

@tobyhodges
Copy link
Member

From feedback received during the pilot lesson at CC@Home2020: the lesson could be improved by adding, or linking out to instructions for deploying HTML files built with Sphinx. It was suggested that readthedocs could be a good choice for this.

@brownsarahm
Copy link
Collaborator

Is using only travis or gh-pages easier? I've only deployed docs with travis, so insight from others on what is the most feasible for actually getting to try it during the workshop would help.

I think that for the purposes of sharing, an "add this file and customize" might be easier than something with a lot of clicking through a gui interface to demonstrate and follow.

Also, need to consider, adding either in this episode or earlier an exercise to put whatever the "working" project is on github if it's not already (eg if learners are using an actual repo of theirs it might already be, if working with a toy it won't be (see: #1)

@brownsarahm brownsarahm added the type:discussion Discussion or feedback about the lesson label Jul 27, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type:discussion Discussion or feedback about the lesson
Projects
None yet
Development

No branches or pull requests

2 participants