[bug #61950] PROBLEMS file not the best place for many of its items

[Dave]

URL:
  <https://savannah.gnu.org/bugs/?61950>

                 Summary: PROBLEMS file not the best place for many of its
items
                 Project: GNU troff
            Submitted by: barx
            Submitted on: Thu 27 Jan 2022 06:29:55 PM CST
                Category: Core
                Severity: 1 - Wish
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

I don't have a proposed solution for this, but I want to log it as something
that could be looked at someday.

The PROBLEMS file claims it "describes various problems that have been
encountered in compiling, installing and running groff."  The file is indeed a
useful place to list issues in compiling and installing the program, as anyone
doing these things has the source tree at hand.

It's a less useful place to address user-facing issues, which is what a lot of
this file is.  Users do not necessarily have such ready access to this file. 
Granted, the source tree is browsable on the web, but the source tree is
probably not where users will think to look upon encountering trouble, and
nothing in our user-facing documentation points readers to this file.

Those items should instead go into some kind of FAQ or troubleshooting list
that is shipped as part of groff's normal documentation and cross-referenced
appropriately.

(Distantly related, bug #57855 proposes creation of an "examples" file, if
someone is looking to take on multiple novice-user-help projects.)




    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?61950>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/