drym-org / qi

An embeddable flow-oriented language.
59 stars 12 forks source link

docs: disambiguate Usage sections #90

Closed benknoble closed 1 year ago

benknoble commented 1 year ago

Summary of Changes

This helps prevent the following class of warnings:

2023-01-25T16:03:22.1514470Z WARNING: collected information for key multiple times: '(index-entry (part "Usage")); values: (list '("Usage") (list (element #f '("Usage"))) (part-index-desc)) (list '("Usage") (list (element #f '("Usage"))) (part-index-desc))
2023-01-25T16:03:22.1516528Z WARNING: collected information for key multiple times: '(part "Usage"); values: (vector '("Usage") '(part "Usage") '(3 2) (list (mobile-root #<path:/home/runner/.local/share/racket/8.7/pkgs/qi-doc/doc/qi>) #"Introduction_and_Usage.html") #f) (vector '("Usage") '(part "Usage") '(3 1 3) (list (mobile-root #<path:/home/runner/.local/share/racket/8.7/pkgs/qi-doc/doc/qi>) #"Tutorial.html") #f)

In particular, it also helps clarify what @secref{Usage} should actually refer to: the Tutorial Usage or the Introduction Usage? I've assumed the latter in adjusting the reference there.

Public Domain Dedication

(Why: The freely released, copyright-free work in this repository represents an investment in a better way of doing things called attribution-based economics. Attribution-based economics is based on the simple idea that we gain more by giving more, not by holding on to things that, truly, we could only create because we, in our turn, received from others. As it turns out, an economic system based on attribution -- where those who give more are more empowered -- is significantly more efficient than capitalism while also being stable and fair (unlike capitalism, on both counts), giving it transformative power to elevate the human condition and address the problems that face us today along with a host of others that have been intractable since the beginning. You can help make this a reality by releasing your work in the same way -- freely into the public domain in the simple hope of providing value. Learn more about attribution-based economics at drym.org, tell your friends, do your part.)

countvajhula commented 1 year ago

Looks good, thanks!