Re: [PATCH -perfbook v4] howto: make ref to git archive explicit

On Wed, Dec 27, 2023 at 6:34 PM Akira Yokosawa <[email protected]> wrote:
>
> On Wed, 27 Dec 2023 17:34:25 +0800, [email protected] wrote:
> > From: Zhouyi Zhou <[email protected]>
> >
> > Make "git archive" in answer to Quick Quiz 1.3 more explicit, so that reader can easily know where
> > "git archive" is.
>
> Now that this patch adds just a footnote mentioning Section 1.5,
> commit log can use some adjustments.
>
> How about:
>
>     Make "git archive" in answer to Quick Quiz 1.3 more explicit by
>     adding a footnote, so that a first-time reader, who have never
>     read Section 1.5, can easily know how to clone the Git repo and
>     build PDFs.
>
The revised version makes the commit log more clear and elegant! I
will submit the 5th version.
Thank you for your beautiful work！
> That said, I'm beginning to wonder how many of first-time readers
> would bother trying -nq builds without having got annoyed by those
> lots of QQz's in perfbook. ;-)
Haha, that's a good point! It's indeed a challenge for first-timers to
dive into nq builds, especially with the complexities
in installing a latex environment and various fonts in Linux desktop
;-) It's quite a learning curve, and it's rewarding in the end.
>
> >
> > Suggested-by: Akira Yokosawa <[email protected]>
> > Signed-off-by: Zhouyi Zhou<[email protected]>
>
> Reviewed-by: Akira Yokosawa <[email protected]>
>
>     Thanks, Akira
Thanks, Zhouyi
>
> > ---
> > Hi Akira
> >
> > Thank you for your valuable suggestions and guidances, I learned a lot
> > during this process ;-)
> >
> > And I invoke make -j 20 in my ubuntu 22.04, everything works great!
> >
> > Our editor Yunjing Li is still too modest to provide her email, sorry.
> >
> > Thanks for your patient and hard work.
> >
> > Thanks
> > Zhouyi
> > --
> >  howto/howto.tex | 4 +++-
> >  1 file changed, 3 insertions(+), 1 deletion(-)
> >
> > diff --git a/howto/howto.tex b/howto/howto.tex
> > index 55270cba..8d678644 100644
> > --- a/howto/howto.tex
> > +++ b/howto/howto.tex
> > @@ -226,7 +226,9 @@ Here are a few possible strategies:
> >       only a blank sheet of paper.
> >  \item        If you find the Quick Quizzes distracting but impossible
> >       to ignore, you can always clone the \LaTeX{} source for
> > -     this book from the git archive.
> > +     this book from the git archive.\footnote{
> > +             See \cref{sec:howto:Whose Book Is This?}
> > +             for instructions to do this.}
> >       You can then run the command \co{make nq}, which will
> >       produce a \co{perfbook-nq.pdf}.
> >       This PDF contains unobtrusive boxed tags where the Quick Quizzes