Merge pull request #584 from harvard-edge/583-pdf-formatting-needs-to…

…-be-improved

583 PDF formatting needs to be improved

_quarto.yml

@@ -341,15 +341,17 @@ format:
     cite-method: citeproc
     title-block-style: none
     indent: 0px
-    fontsize: 10pt
-
+    fontsize: 9pt
+    colorlinks: true
+
     reference-location: margin
     citation-location: block
 
     fig-caption: true
     cap-location: margin
     fig-cap-location: margin
     tbl-cap-location: margin
+    tbl-colwidths: auto
     hyperrefoptions:
       - linktoc=all
       - pdfwindowui

contents/core/data_engineering/data_engineering.qmd

@@ -267,7 +267,7 @@ The dataset cards provide important context on appropriate dataset usage by high
 
 **Data Governance:** With a large amount of data storage, it is also imperative to have policies and practices (i.e., data governance) that help manage data during its life cycle, from acquisition to disposal. Data governance outlines how data is managed and includes making key decisions about data access and control. @fig-governance illustrates the different domains involved in data governance. It involves exercising authority and making decisions concerning data to uphold its quality, ensure compliance, maintain security, and derive value. Data governance is operationalized by developing policies, incentives, and penalties, cultivating a culture that perceives data as a valuable asset. Specific procedures and assigned authorities are implemented to safeguard data quality and monitor its utilization and related risks.
 
-![An overview of the data governance framework. Source: [StarCIO.](https://www.groundwatergovernance.org/the-importance-of-governance-for-all-stakeholders/).](images/jpg/data_governance.jpg){#fig-governance}
+![An overview of the data governance framework. Source: [StarCIO](https://www.groundwatergovernance.org/the-importance-of-governance-for-all-stakeholders/).](images/jpg/data_governance.jpg){#fig-governance}
 
 Data governance utilizes three integrative approaches: planning and control, organizational, and risk-based.
 

contents/core/introduction/introduction.qmd

@@ -119,7 +119,7 @@ The move to statistical approaches fundamentally changed how we think about buil
 |                     |                          | specific                 |                          |                               |
 +---------------------+--------------------------+--------------------------+--------------------------+-------------------------------+
 
-: Evolution of AI - Key Positive Aspects {#tbl-ai-evolution-strengths .hover .striped}
+: Evolution of AI - Key Positive Aspects {#tbl-ai-evolution-strengths .hover .striped .column-page-right}
 
 The table serves as a bridge between the early approaches we've discussed and the more recent developments in shallow and deep learning that we'll explore next. It sets the stage for understanding why certain approaches gained prominence in different eras and how each new paradigm built upon and addressed the limitations of its predecessors. Moreover, it illustrates how the strengths of earlier approaches continue to influence and enhance modern AI techniques, particularly in the era of foundation models.
 
@@ -420,7 +420,7 @@ This book is designed to guide you from understanding the fundamentals of ML sys
 
 ![Overview of the five fundamental system pillars of Machine Learning Systems engineering.](images/png/book_pillars.png){#fig-pillars}
 
-As illustrated in Figure @fig-pillars, the five pillars central to the framework are:
+As illustrated in @fig-pillars, the five pillars central to the framework are:
 
 - **Data**: Emphasizing data engineering and foundational principles critical to how AI operates in relation to data.
 - **Training**: Exploring the methodologies for AI training, focusing on efficiency, optimization, and acceleration techniques to enhance model performance.

contents/core/ml_systems/ml_systems.qmd

@@ -536,7 +536,7 @@ The operational characteristics of these systems reveal another important dimens
 +--------------------------+----------------------------------------------------------+----------------------------------------------------------+-----------------------------------------------------------+----------------------------------------------------------+
 | Data Privacy             | Basic-Moderate (Data leaves device)                      | High (Data stays in local network)                       | High (Data stays on phone)                                | Very High (Data never leaves sensor)                     |
 +--------------------------+----------------------------------------------------------+----------------------------------------------------------+-----------------------------------------------------------+----------------------------------------------------------+
-| Computational Power      | Very High (Multiple GPUs/TPUs)                           | High (Edge GPUs)                                         | Moderate (Mobile NPUs/GPUs)                               | Very Low (MCU/tiny processors)                           |
+| Compute Power            | Very High (Multiple GPUs/TPUs)                           | High (Edge GPUs)                                         | Moderate (Mobile NPUs/GPUs)                               | Very Low (MCU/tiny processors)                           |
 +--------------------------+----------------------------------------------------------+----------------------------------------------------------+-----------------------------------------------------------+----------------------------------------------------------+
 | Energy Consumption       | Very High (kW-MW range)                                  | High (100s W)                                            | Moderate (1-10W)                                          | Very Low (mW range)                                      |
 +--------------------------+----------------------------------------------------------+----------------------------------------------------------+-----------------------------------------------------------+----------------------------------------------------------+

contents/frontmatter/ai/socratiq.qmd

@@ -254,10 +254,12 @@ For persistent issues, please contact us at vj[@]eecs.harvard.edu.
 
 ## Providing Feedback
 
-Your feedback helps us improve SocratiQ. You can report technical issues, suggest improvements to quiz questions, or share thoughts about AI responses using the feedback buttons located throughout the interface.
+Your feedback helps us improve SocratiQ. 
 
-You can submit a [GitHub issue](https://github.com/harvard-edge/cs249r_book/issues), or if you prefer leaving feedback via Google Form, you are welcome to do so via this link:
+You can report technical issues, suggest improvements to quiz questions, or share thoughts about AI responses using the feedback buttons located throughout the interface. You can submit a [GitHub issue](https://github.com/harvard-edge/cs249r_book/issues).
 
-[Share Your Feedback]{.btn .btn-primary onclick="window.open('https://docs.google.com/forms/d/e/1FAIpQLSeK8RXgc6kbT1IbWVLjyUhwowp3x1ySbAjUQQqztdDs5ccmmQ/viewform?embedded=true', '_blank')"}
+```{=html}
+If you prefer leaving feedback via Google Form, you are welcome to do so via this link:
 
-Remember: SocratiQ is designed to help you learn effectively. By consistently engaging with the quizzes, asking questions when needed, and tracking your progress, you'll get the most out of this AI learning assistant.
+[Share Your Feedback]{.btn .btn-primary onclick="window.open('https://docs.google.com/forms/d/e/1FAIpQLSeK8RXgc6kbT1IbWVLjyUhwowp3x1ySbAjUQQqztdDs5ccmmQ/viewform?embedded=true', '_blank')"}
+```

tex/header-includes.tex

@@ -1,28 +1,41 @@
 % Package imports
 
 \usepackage[english]{babel}
-\usepackage{caption}
+\usepackage[outercaption, ragged]{sidecap}
+\usepackage{adjustbox}
 \usepackage{afterpage}
+\usepackage{array}
 \usepackage{atbegshi} % Package to insert content at the beginning
-\usepackage{etoolbox}
+\usepackage{caption}
+\usepackage{etoolbox}      % For redefining footnotes
 \usepackage{fancyhdr}
 \usepackage{fontspec}
 \usepackage{geometry}
 \usepackage{graphicx}
 \usepackage{hyperref}
+\usepackage{ifthen}
+\usepackage{longtable}
 \usepackage{marginfix} % Fixes the issue of margin notes being cut off
 \usepackage{marginnote}
 \usepackage{mathptmx}
 \usepackage{newpxtext} % Palatino-like font
 \usepackage{ragged2e}
-\usepackage{longtable}
+\usepackage{sidenotes}
 \usepackage{titlesec}
 \usepackage{tocloft}
 \usepackage{xcolor}
-\usepackage[outercaption, ragged]{sidecap}
-\usepackage{etoolbox}      % For redefining footnotes
-\usepackage{sidenotes}
-\usepackage{ifthen}
+\usepackage{changepage}
+
+\geometry{
+  paperwidth=7.5in,
+  paperheight=9.25in,
+  top=1in,
+  bottom=1in,
+  inner=1in,
+  outer=2.25in,
+  marginparwidth=1.5in,
+  twoside
+}
 
 % Define the Crimson color
 \definecolor{crimson}{HTML}{A51C30}
@@ -185,7 +198,7 @@
 \renewcommand{\chaptername}{Chapter}
 
 \setcounter{tocdepth}{2}
-\setlength{\cftsecnumwidth}{2.35em} % Adjust width for section numbers
+\setlength{\cftsecnumwidth}{2.75em} % Adjust width for section numbers
 \setlength{\cftsubsecnumwidth}{3.25em} % Adjust width for subsection numbers
 \setlength{\cftsubsubsecnumwidth}{4em} % Adjust width for subsubsection numbers
 
@@ -236,4 +249,6 @@
   \fi
   \old@chapter*{#1}%
 }
-\makeatother
+\makeatother
+
+\AtBeginEnvironment{longtable}{\scriptsize} % Adjust to \footnotesize or \scriptsize if needed