[haiku-i18n] Re: Haiku User Guide: "Reporting bugs" bugs
- From: "Humdinger" <dmarc-noreply@xxxxxxxxxxxxx> (Redacted sender "humdingerb" for DMARC)
- To: haiku-i18n@xxxxxxxxxxxxx
- Date: Thu, 28 Dec 2017 17:52:27 +0100
Hi KapiX!
On 26/12/2017, Kacper Kasper <kacperkasper@xxxxxxxxx> wrote:
and I found some places
that should be improved in the original.
I went with most of your suggestions, have a look if it needs further
improvmenents.
"Server bugs
You can also "shutdown" or "restart" the computer from KDL instead of
pressing the power button (and this paragraph assumes keyboard does
work).
Sure, without keyboard the KDL is a pretty boring place :)
No need to point that out so, I'd say.
[...] PS/2 keyboards always do, USB keyboards connected via UHCI
controllers do only, if one has entered KDL via the keyboard shortcut
at least once. USB OHCI is not supported at the moment."
Is this still true?
I dunno either. On IRC PulkoMandy said that "IIRC OHCI is still not
supported, but EHCI is". One would have to check that first though...
I only have a laptop here with no external keyboard near at the
moment.
[...]
- open /var/log/syslog The primary system log used by Haiku, akin to
on screen debugging during boot. With the open command you can crop
down the relevant part of the syslog in a text editor.
[...]"
IMO the phrasing here should be something like "System log described
above.", since it's described in detail two sections before.
I linked to the "Syslog" section above, but kept the little bit about
opening with "open" to edit the log.
I also think User Guide relies too much on links to website pages. The
issue with that is website is not localized and I don't think it
can/should be. Some of the information should be moved to User Guide
and the website should link there, not the other way around.
Generally agreed. We have to weigh what's really end-user relevant
though, and what's just interesting information for a small subset of
users. Adding non-vital pages always creates quite some workload
quickly, if you consider all the translations, of course.
If you have specific suggestion...
--
Regards,
Humdinger
--
Did you know:
If half the Haiku supporters at
http://www.goodsearch.com
made 10 searches a day, we could have a fulltime developer.
Other related posts:
