Attempt to improve FAQ readability

This commit is contained in:
anthonydb 2023-02-18 15:17:10 -05:00
parent 2d2b4562ac
commit 280522fcbe

View File

@ -12,17 +12,17 @@ None yet
### Chapter 1: Setting Up Your Coding Environment
**Page 3: Downloading Code and Data from GitHub**
* **Page 3: Downloading Code and Data from GitHub**
The GitHub folder name has been renamed to `practical-sql-2-main` from `practical-sql-2-master` in line with GitHub conventions.
> The GitHub folder name has been renamed to `practical-sql-2-main` from `practical-sql-2-master` in line with GitHub conventions.
**Page 13: pgAdmin Dialog to Create Server**
* **Page 13: pgAdmin Dialog to Create Server**
The location of the pgAdmin dialog to add a server has changed. Now, in the object browser, right-click `Servers` and then click `Register` > `Server`. The remaining steps in the Note on page 13 are the same. (Formerly, the dialog was accessed by right-clicking `Servers` and selecting `Create` > `Server`.)
> The location of the pgAdmin dialog to add a server has changed. Now, in the object browser, right-click `Servers` and then click `Register` > `Server`. The remaining steps in the Note on page 13 are the same. (Formerly, the dialog was accessed by right-clicking `Servers` and selecting `Create` > `Server`.)
**Page 15, Figure 1-5: pgAdmin Query Tool**
* **Page 15, Figure 1-5: pgAdmin Query Tool**
Version 6.9 of pgAdmin, released in May 2022, introduced a redesigned Query Tool Layout. General functionality is the same, but if you are using version 6.9 or later, you will see that some menu icons shown in the book at the top of the window are now placed atop the results grid.
> Version 6.9 of pgAdmin, released in May 2022, introduced a redesigned Query Tool Layout. General functionality is the same, but if you are using version 6.9 or later, you will see that some menu icons shown in the book at the top of the window are now placed atop the results grid.
### Chapter 2: Creating Your First Database and Table
@ -39,9 +39,9 @@ None yet
### Chapter 5: Importing and Exporting Data
**Page 65, Understanding Census Columns and Data Types**
* **Page 65, Understanding Census Columns and Data Types**
The URL for the 2010 Census technical documentation has been moved to [https://www2.census.gov/programs-surveys/decennial/rdo/about/2010-census-programs/2010Census_pl94-171_techdoc.pdf](https://www2.census.gov/programs-surveys/decennial/rdo/about/2010-census-programs/2010Census_pl94-171_techdoc.pdf)
> The URL for the 2010 Census technical documentation has been moved to [https://www2.census.gov/programs-surveys/decennial/rdo/about/2010-census-programs/2010Census_pl94-171_techdoc.pdf](https://www2.census.gov/programs-surveys/decennial/rdo/about/2010-census-programs/2010Census_pl94-171_techdoc.pdf)
### Chapter 6: Basic Math and Stats with SQL
@ -78,29 +78,29 @@ None yet
### Chapter 14: Mining Text to Find Meaningful Data
**Pages 253, etc.: Turning Text to Data with Regular Expression Functions**
* **Pages 253, etc.: Turning Text to Data with Regular Expression Functions**
The dates of crimes in this section are in the format MM/DD/YY. If your database has a `datestyle` setting other than `MDY` -- for example if you're in Europe -- then you will likely need to set your `datestyle` to complete the examples.
> The dates of crimes in this section are in the format MM/DD/YY. If your database has a `datestyle` setting other than `MDY` -- for example if you're in Europe -- then you will likely need to set your `datestyle` to complete the examples.
Check your `datestyle` by running this query in pgAdmin:
> Check your `datestyle` by running this query in pgAdmin:
```
SHOW datestyle;
```
If the result is other than `ISO, MDY`, you can set the `datestyle` on a per-session basis by running this command:
> If the result is other than `ISO, MDY`, you can set the `datestyle` on a per-session basis by running this command:
```
SET datestyle to "ISO, MDY";
```
You can then complete the examples. The change will persist until you restart pgAdmin.
> You can then complete the examples. The change will persist until you restart pgAdmin.
### Chapter 15: Analyzing Spatial Data with PostGIS
**Pages 282, etc.: Geometry Viewer Results Grid Icon**
* **Pages 282, etc.: Geometry Viewer Results Grid Icon**
Beginning with version 6.9 of pgAdmin, released in May 2022, the icon to launch the Geometry Viewer in the result column header was changed from an eye to a map (makes sense). On Page 282 and later in the book, I mention clicking the eye icon to launch the viewer. Now, instead, click the map icon.
> Beginning with version 6.9 of pgAdmin, released in May 2022, the icon to launch the Geometry Viewer in the result column header was changed from an eye to a map (makes sense). On Page 282 and later in the book, I mention clicking the eye icon to launch the viewer. Now, instead, click the map icon.
### Chapter 16: Working With JSON Data
@ -121,9 +121,9 @@ None yet
### Index
**Page 417: IN comparison operator**
* **Page 417: IN comparison operator**
The entry should reference pages 36, 172, 229.
> The entry should reference pages 36, 172, 229.