PCT essentials

[usr110]

and also added text for case-studies. Please view the outputs using these:

https://htmlpreview.github.io/?https://github.com/npct/pct-shiny/blob/4bfb33c1d50dc8f3f97d02fb5b4690447b3728ac/regions_www/index.html

https://htmlpreview.github.io/?https://github.com/npct/pct-shiny/blob/pct_essentials/regions_www/tabs/manual_body.html

P.S. The link to the pdf is specific to the branch - in this case, pct_essentials. Once we are happy with the changes, I will change it to the master branch. Please don't merge it without this change.

[Robinlovelace]

Looks good to me @usr110, will await reviews from @AnnaGoodman1 and @nikolai-b as requested. Great work!

[usr110]

Cheers @Robinlovelace

Re merge, I think it's ready. I have used a commit's SHA instead of branch name.

@JDWoodcock have made the document a two pager.

[Robinlovelace]

One question, probably for another day/month, but would it be worth storing the source code/text of the 'essentials' document in an easy-to-edit plain text format like .md?

[usr110]

One question, probably for another day/month, but would it be worth storing the source code/text of the 'essentials' document in an easy-to-edit plain text format like .md?

It's always easy to manage text when in plain form, so I do agree with the suggestion. We just need to think how best to keep all text at one place. Indeed something to think about for the future.

[AnnaGoodman1]

As per my email to you, looks great but also to add/edit:

How to use the Propensity to Cycle Tool (PCT)
The material here was developed between 2016 and 2019 for use in training. To request more information or provide feedback, please email us at pct@pct.bike or report issues on our GitHub issue tracker. The PCT also has a blog, which contains further information on some of the topics featured in the case studies and FAQs. Contributions to GitHub, the blog or other parts of the project are welcome.

[usr110]

As per my email to you, looks great but also to add/edit:

How to use the Propensity to Cycle Tool (PCT)
The material here was developed between 2016 and 2019 for use in training. To request more information or provide feedback, please email us at pct@pct.bike or report issues on our GitHub issue tracker. The PCT also has a blog, which contains further information on some of the topics featured in the case studies and FAQs. Contributions to GitHub, the blog or other parts of the project are welcome.

Thanks @AnnaGoodman1 . Have made these changes. Please see the changes here

[Robinlovelace]

Looking good to me. While we're adding the essentials document is it worth adding links to other training resources? I've put in a PR #831 that adds a link to the advanced training materials delivered last year and to be delivered this year: https://htmlpreview.github.io/?https://github.com/npct/pct-shiny/blob/Robinlovelace-patch-1/regions_www/tabs/manual_body.html

If @RachelAldred and others would you be happy to share the intermediate/intro training courses also I think the Essentials -> Introductory -> Intermediate -> Advanced links could provide good stepping stones for people to develop their understanding of the project, providing good links for every level.

[nikolai-b]

I'm fine with the change. Personally I'm less happy with PDFs as a format but that's just me.
👍

[nikolai-b]

Sorry to be a bit of a pain but I'd prefer this to be

https://npct.github.io/pct-shiny/regions_www/www/static/03d_other_reports/2020-pct-essentials.pdf

as Github pages are designed as a CDN whereas the cdn.rawgit.com is a bit of a hack and might change.

[nikolai-b]

same here.

Also is this meant to be:

Read our two pager

[usr110]

Thanks @nikolai-b
I wanted to use it but for a test I had used raw git. Now have updated the links.

[Robinlovelace]

Personally I'm less happy with PDFs as a format but that's just me.

Agreed, will also help build our web presence if we have a html page with all the hyperlinks on our site. Can draft a docx -> html conversion, although I'm in favour of having both pdf and html as PDFs are a nice format for sending people and printing as a two-pager.

[Robinlovelace]

And @nikolai-b I guess this comment:

Sorry to be a bit of a pain but I'd prefer this to be

https://npct.github.io/pct-shiny/regions_www/www/static/03d_other_reports/2020-pct-essentials.pdf

Means we just need to wait until it's on master before the link works (as GH-pages builds from master). I agree that is consistent and makes sense.