Adds intro, outline

thedivtagguy · Apr 16, 2023 · 0c0dec6 · 0c0dec6
1 parent a3a8b32
commit 0c0dec6
Show file tree

Hide file tree

Showing 11 changed files with 49 additions and 6 deletions.
diff --git a/01-intro.Rmd b/01-intro.Rmd
@@ -3,15 +3,19 @@
 
 ## Motivation
 
-In the past, I haven't paid much attention to the challenges related to urban development. Although I have been aware of the issues with poor infrastructure in cities in India, I never fully grasped the severity of the problem, nor did I connect the individual inconveniences I experienced to a larger systemic issue. Admittedly, this lack of awareness could be viewed as naive or shortsighted, but it is what it is.
+Walking in a city is an experience that most people take for granted. The ease of mobility on foot, especially in urban areas, has long been overshadowed by the convenience and speed provided by personal vehicles or public transportation systems. Until recently, I was also among those who overlooked and underappreciated its importance. Although I have been aware of the issues with poor infrastructure in cities in India, I never fully grasped the severity of the problem, nor did I connect the individual inconveniences I experienced to a larger systemic issue. Admittedly, this lack of awareness could be viewed as naive or shortsighted, but it is what it is.
 
-However, in 2021, my perspective changed when I stumbled upon an Instagram account called "bengawalk" run by Pravar Chaudhary. Through this account, Pravar documented his observations of the streets and people of Bangalore, highlighting a range of issues and interactions that occur on a daily basis. Whether it was a simple post about wayfinding, accompanied by a single hashtag or a video of person crossing a busy street despite being next to a footbridge, to a more complex analysis of traffic congestion and flyovers, the account provided me with a new lens through which to view the city and its challenges. 
+However, in 2021, my perspective changed when I stumbled upon an Instagram account called "bengawalk" run by **Pravar Chaudhary**. Through this account, Pravar documented his observations of the streets and people of Bangalore, highlighting a range of issues and interactions that occur on a daily basis. Whether it was a simple post about wayfinding, accompanied by a single hashtag or a video of person crossing a busy street despite being next to a footbridge, to a more complex analysis of traffic congestion and flyovers, the account provided me with a new lens through which to view the city and its challenges. 
 
+As a designer and a person interested in using data to understand problems, this appealed to me as one of the most tangible, omnipresent topic that I had _never_ fully paid attention to. From there, I have read through countless documents on urban mobility, walkability, transport and streets; admittedly one of the best rabbit-holes I've fallen into. The data-storytelling enthusiast in me always wants to find ways to mould information into a spreadsheet I can import into R or a shapefile I can visualize in QGIS, which is what I did with this too.
 
+The more I've engaged with walkability and urban mobility, though, I've realized that quantitative data is often not enough to describe something as complex as streets and transport, or the people who use them. In my research on street usage and accessibiilty in Ejipura, Bangalore, several new insights came up through qualitative analyses that I would have completely missed if I was focusing on large numbers. I was also lucky enough to work with people more experienced than I was who brought with them different, unique ways to analyze urban environments.
 
-As a designer and a person interested in using data to understand problems, this appealed to me as one of the most tangible, omnipresent topic that I had _never_ fully paid attention to. From there, I have read through countless documents on urban mobility, walkability, transport and streets; admittedly one of the best rabbit-holes I've fallen into. The data-storytelling enthusiast in me always wants to find ways to mould information into a spreadsheet I can import into R or a shapefile I can visualize in QGIS, which is what I did with this too.
+This book is a distillation of things I, and others, learnt along the way. 
+
+It is a crowd-sourced, community contributed repository of resuable methodologies anyone can use to explore walkability and accessibility for different contexts. Through qualitative analysis, community engagement, and data-driven approaches such as those discussed here, we can try to gain a deeper understanding of our streets and how they impact individuals from all walks of life.
 
-The more I've engaged with walkability and urban mobility, though, I've realized that quantitative data is often not enough to describe something as complex as streets and transport, or the people who use them. In my research on street usage and accessibiilty in Ejipura, Bangalore, several new insights came up through qualitative analyses that I would have completely missed if I was focusing on large numbers. 
+The methodologies presented in this book are just a starting point - there is still much work to be done!
 
 ## Scope
 ## Who is this for?

diff --git a/07-interpreting.Rmd b/07-interpreting.Rmd
@@ -1,5 +1,7 @@
 # (PART) Case Studies {-} 
 # Interpreting and Presenting Results {#presentation}
+The title of this document is **`r rmarkdown::metadata$title`**
+
 
 ## Communicating Results
 

diff --git a/16-contributors.Rmd b/16-contributors.Rmd
@@ -0,0 +1 @@
+# Contributors
diff --git a/Rplots.pdf b/Rplots.pdf
diff --git a/index.Rmd b/index.Rmd
@@ -1,7 +1,7 @@
 ---
 title: "The Walkability Wiki"
 subtitle: "Methods for Measuring Pedestrian Experience"
-author: "Aman Bhargava"
+author: "multiple contributors"
 date: "`r Sys.Date()`"
 knit: "bookdown::render_book"
 site: bookdown::bookdown_site
@@ -26,6 +26,10 @@ knitr::write_bib(c(
 
 knitr::include_graphics(rep("static/cover.png"))
 
+outline_content <- function(href, img_src, heading, content) {
+  paste0('<a href="', href, '" target="_blank"><div class="card-menu" style="display:flex; width:100%;"><div class="side1"><p><img class="inline-image" style="width:200px; height:200px;" src="', img_src, '" style="display: block; margin: auto;"></p></div><div class="side2"><h4 id="', make.names(heading), '" class="hasAnchor">', heading, '</h4><p>', content, '</p></div></div></a>')
+}
+
 
 ```
 
@@ -46,4 +50,25 @@ knitr::include_graphics(rep("static/cover.png"))
 ```
 This is the [website](http://walkability.wiki/) for *The Walkability Wiki*, a crowd-sourced cookbook of qualitative & quantitative methods for measuring pedestrian experience! Visit the [GitHub repository for this site](https://github.com/thedivtagguy/walkability-wiki).
 
+The content for this guide has been contributed by multiple people, the full list of which can be viewed here. If you are someone who studies urban development, or have engaged with studying walkability in any measure, we'd love to have you here too. 
+
+Contribution guidelines are available here and can be submitted via pull requests to our main repository.
+
+
+## Outline {.unnumbered}
+
+
+This book has been divided into the following categories to make it easier to get through:
+
+`r outline_content('google.com', 'static/scope.png', 'Getting Started', 'Overview of the book, including the motivations for writing it, the scope of what it covers, and an introduction to the various ideas surrounding walkability.')`
+
+`r outline_content('google.com', 'static/quant.png', 'Quantitative Methods', 'Sourcing data for street and urban environment assessments, recipes for processing and analysing data, creating maps, running numbers.')`
+
+`r outline_content('google.com', 'static/qual.png', 'Qualitative Methods', 'Tips for conducting interviews, designing street audits, ideas for how to frame questions to get good information, designing participatory activities.')`
+
+`r outline_content('google.com', 'static/gap.png', 'Bridging the Gap', 'Combining two different methods to fill in gaps, deriving insights, ways of infering and presenting results for analysis.')`
+
+`r outline_content('google.com', 'static/case.png', 'Case Studies', 'Real-life examples of street audits in various contexts and locations, tools they used and how they did their analysis.')`
+
+
 <a rel="license" href="http://creativecommons.org/licenses/by-nc/4.0/"><img src="https://i.creativecommons.org/l/by-nc/4.0/88x31.png" alt="Creative Commons License" style="border-width:0"/></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc/4.0/">Creative Commons Attribution-NonCommercial 4.0 International License</a>.
diff --git a/static/case.png b/static/case.png
diff --git a/static/gap.png b/static/gap.png
diff --git a/static/qual.png b/static/qual.png
diff --git a/static/quant.png b/static/quant.png
diff --git a/static/scope.png b/static/scope.png
diff --git a/style.css b/style.css
@@ -106,7 +106,7 @@ color: #44344F !important;
 }
 
 .section.level2 {
-  border-bottom: 2px black;
+  border-bottom: 2px black !important;
 }
 
 
@@ -117,3 +117,14 @@ color: #44344F !important;
 .book-toc.list-unstyled li.book-part:not(:first-child) {
   font-weight: 600;
 }
+
+li.appendix span, li.part span { /* for TOC part names */
+  margin-top: 1em;
+  color: color: #1c3046 !important;
+  opacity: 1 !important;
+  text-transform: uppercase;
+}
+
+.card-menu {
+  padding: 0 10px;
+}