Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix-up BOZOs in documentation #812

Open
ragerdl opened this issue Jan 10, 2018 · 0 comments
Open

Fix-up BOZOs in documentation #812

ragerdl opened this issue Jan 10, 2018 · 0 comments

Comments

@ragerdl
Copy link
Member

ragerdl commented Jan 10, 2018

Kaufmann writes:

I did a search in the documentation for BOZO (or bozo) and found a
bunch of occurrences (many dozens). I wonder if it would be best to
change these so that they make sense to users who don't know that
"BOZO" means something like "A problem to be considered:"; or perhaps
BOZO could be a topic and its occurrences could be links.

My most recent commit (below) dealt with just a few that I was
particularly concerned about.

It would be great if anyone(s) would deal with some other BOZOs. It
would be particularly nice to remove the one about quicklisp in
NOTE-7-0-BOOKS, which to me seems particularly egregious since anyone
might read that topic, not just someone reading the more specialized
topics that typically contain BOZOs.

By the way, I'm not complaining -- I'm pretty sure those BOZOs are
there because someone wrote tons of documentation and wanted to keep
moving, rather than to deal with every little issue. And it's great
that those issues are documented (i.e., with those BOZOs). But if
someone(s) cared to clean up some of them, so much the better.

Seems like a good idea to me. Making it an issue so that people can find it when they're bored.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant