Skip to content

Commit 31fe3ac

Browse files
committed
added two references on ai code generation and fixed the "i" in "Ni Hao"
1 parent 7ac676b commit 31fe3ac

File tree

3 files changed

+7
-3
lines changed

3 files changed

+7
-3
lines changed

bookbase

text/main/basics/simpleDataTypesAndOperations/documentation/documentation.tex

+5-1
Original file line numberDiff line numberDiff line change
@@ -441,9 +441,13 @@
441441
All of these tools can guide you to the right answer.
442442
However, at least of today, they provide answers that, ultimately, are grounded on human experience.
443443
And humans make errors.
444+
There are two (known) differences between \pgls{AI} tools and human-written sources, though.
445+
First, \pgls{AI} tools can make errors that no human would make.
446+
An illustrative example in the \python\ world is given in~\cite{BSHETB:VSK2025CIC}, where it is documented that Microsoft Copilot renamed a class in a misleading way, leading to a particularly hard-to-find error.
447+
Second, sometimes, an \pgls{AI} may reference non-existing packages~\cite{AT:G2025AGCCBADFTSSCHW}.
444448
Therefore, once you found an answer to your question, you need to take the new information and check it with the documentation.
445449

446-
As example, in this section, we were looking for a function that rounds floating point numbers towards positive infinity.
450+
Anyway, as example for searching information using \pgls{AI} tools, we looked for a function that rounds floating point numbers towards positive infinity.
447451
We did not know what this function was called~(or whether it even exists).
448452
The \pgls{AI} told us that it was called \pythonilIdx{ceil}.
449453
Instead of just using \pythonilIdx{ceil} in our code directly, we then would go back to the official \python\ documentation and search for \pythonilIdx{ceil}.

text/main/basics/simpleDataTypesAndOperations/str/str.tex

+1-1
Original file line numberDiff line numberDiff line change
@@ -462,7 +462,7 @@
462462
If we use the \pythonil{\\u}-based\pythonIdx{\textbackslash{u}} escape, then we can represent \emph{any} character as Basic Latin text sequence.
463463
It is also useful if we want to, e.g., enter Chinese text on a machine that does not have an IME or other corresponding tools, or text in any other kind of language where we do not have corresponding keys on the keyboard (see, e.g., \cref{lst:variables:pi_liu_hui} later on).
464464

465-
Anyway, in \cref{fig:strUnicodeEscape}, we use the information obtained in \cref{fig:unicodeCharacterTableSubset} to print the Chinese text \inQuotes{你好。} standing for \inQuotes{Hello.} and pronounced as \inQuotes{N{\v{i}} h{\v{a}}o.} as a unicode-escaped string.
465+
Anyway, in \cref{fig:strUnicodeEscape}, we use the information obtained in \cref{fig:unicodeCharacterTableSubset} to print the Chinese text \inQuotes{你好。} standing for \inQuotes{Hello.} and pronounced as \inQuotes{N{\v{\i}} h{\v{a}}o.} as a unicode-escaped string.
466466
We found that the character for \inQuotes{你} has unicode number~4f60, \inQuotes{好} has~597d, and the big period~\inQuotes{。} has~3002.
467467
The string \pythonil{"\\u4f60\\u597d\\u3002"} then corresponds to the correct Chinese text~\inQuotes{你好。}.%
468468
\endhsection%

0 commit comments

Comments
 (0)