Adds scope, note blocks

01-intro.Rmd

@@ -1,24 +1,52 @@
-# (PART) Getting Started {-} 
+# (PART) Getting Started {.unnumbered}
+
 # Introduction {#intro}
 
 ## Motivation
 
 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.
+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.
 
-This book is a distillation of things I, and others, learnt along the way. 
+This book is a distillation of things I, and others, learnt along the way.
+
+:::warn
+You use a div tip by writing `:::` following by the name that you assigned to it in the CSS after the `div`.
+:::
 
 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 methodologies presented in this book are just a starting point - there is still much work to be done!
 
-## Scope
+## What This Is & Isn't
+
+There are some things to keep in mind while using this book, so that you make the most of it.
+
+This cookbook **will**:
+
+1. Demonstrate how to combine methods for better understanding walkability.
+2. Present real-life case studies to illustrate how this information can be practically used.
+3. Provide resources for urban planning professionals, academics, and anyone interested in the field to conduct their own research.
+4. Provide a framework for assessing walkability and encourages readers to draw their own conclusions based on their research and analysis
+
+But we **won't**:
+
+1. Aim to provide an exhaustive list of measures or a comprehensive review of research.
+2. Claim to offer a one-size-fits-all solution for assessing walkability.
+3. Provide technical guidance on every aspect of GIS and data analysis, only practical techniques and code snippets.
+4. Aim to be prescriptive or offer definitive answers on what makes a city or street walkable
+
+
+:::note
+You use a div tip by writing `:::` following by the name that you assigned to it in the CSS after the `div`.
+:::
+
 ## Who is this for?
+
 ## How to read this book
-## Structure of the book
 
+## Structure of the book

book.bib

@@ -23,3 +23,9 @@ @article{adhvaryu2019
 	url = {https://www.sciencedirect.com/science/article/pii/S2213624X17302134},
 	langid = {en}
 }
+
+@book{leon,
+	title = {Introduction | rstudio4edu},
+	author = {Leon, {Desirée De} and Hill, Alison},
+	url = {https://rstudio4edu.github.io/rstudio4edu-book/}
+}

index.Rmd

@@ -50,25 +50,22 @@ outline_content <- function(href, img_src, heading, content) {
 ```
 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. 
+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/scope.png', 'Getting Started', 'This section provides an overview of the book, outlining its purpose, scope, and an introduction to the concepts of walkability.')`
 
-`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/quant.png', 'Quantitative Methods', 'This section includes guidance on sourcing data for street and urban environment assessments, recipes for processing and analyzing data, creating maps, and running numbers.')`
 
-`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/qual.png', 'Qualitative Methods', 'This section offers tips for conducting interviews, designing street audits, framing questions to elicit valuable information, and creating participatory activities.')`
 
-`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.')`
+`r outline_content('google.com', 'static/gap.png', 'Bridging the Gap', 'This section explains how to combine qualitative and quantitative methods to fill in gaps, derive insights, and present results for analysis.')`
 
+`r outline_content('google.com', 'static/case.png', 'Case Studies', 'This section features real-life examples of street audits in various contexts and locations, detailing the tools used and the analysis methods employed.')`
 
 <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>.

style.css

@@ -40,6 +40,10 @@ body p {
       font-family: 'Source Sans Pro', sans-serif;
 }
 
+body ul {
+
+}
+
 h1, h2, h3, h4, h5 {
   font-family: 'Bree Serif', serif;
 }
@@ -128,3 +132,54 @@ li.appendix span, li.part span { /* for TOC part names */
 .card-menu {
   padding: 0 10px;
 }
+
+#outline > a:hover {
+  text-decoration: none;
+}
+
+
+.card-menu:hover {
+  background: #e2e2e2;
+}
+
+
+/* -----------Sidebar div tips------------- */
+/* from r-pkgs.org*/
+
+  div.note {
+    padding: 1em;
+    margin: 1em 0;
+    padding-left: 100px;
+    background-size: 70px;
+    background-repeat: no-repeat;
+    background-position: 15px center;
+    color: #000000;
+    background-color: #F5F5F5;
+  border-right: solid 5px #6D5A72;
+  }
+
+    div.warn {
+    padding: 1em;
+    margin: 1em 0;
+    padding-left: 100px;
+    background-size: 70px;
+    background-repeat: no-repeat;
+    background-position: 15px center;
+    color: #ffffff;
+    background-color: #D9594C;
+  border-right: solid 5px #87271D;
+  }
+
+
+div.note {
+  background-image: url("../static/note.svg");
+}
+
+div.fyi {
+ background-image: url("../static/fyi.png");
+}
+
+div.warn {
+  background-image: url("../static/warn.svg");
+}
+