[Koha-bugs] [Bug 26977] New: Update Koha Documentation to use absolute paths instead of relative ones

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26977

            Bug ID: 26977
           Summary: Update Koha Documentation to use absolute paths
                    instead of relative ones
 Change sponsored?: ---
           Product: Koha
           Version: master
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P5 - low
         Component: Documentation
          Assignee: koha-bugs at lists.koha-community.org
          Reporter: rex at nicic.gov
        QA Contact: testopia at bugs.koha-community.org

Hi,

I'm new to Koha, the previous Koha expert left their position a number of years
ago and we left our version running along until the server crashed during an OS
update. After that, I had to build a new server from scratch, install and
upgrade Koha and get it working. 

I would like to ask that the Koha documentation be updated to make it easier
for new people to learn Koha.

Request: Please provide at least one absolute path location (rather than
relative paths) when referring to file locations in a section. 

One example is the Cron jobs and Daemons page. I guess under the Cron Jobs
subheading, I'm supposed to infer where files are located in the OS based on my
flavor, but for someone new like me who is now responsible for becoming the
expert on Koha, it would really ease my learning curve to have an absolute path
offered at least once on the page. 

The relative paths on the page give me no indication of absolute location and
even the Cron jobs description is making a huge assumption as to the user
having knowledge that the writer of the documentation does. The text suggests
that the files are in misc/ or bin/ but doesn't state that those are to be
found in /usr/share/koha/, which would really help. 

Alternatively, a find command suggestion could be offered under the "Cron jobs"
subheading for the user to locate the files.

Since Koha files can be found in so many places, a new person like me doesn't
know where to look and at least one absolute path to help someone get started
and have a little confidence that they're finding the right file would be
really nice.

-- 
You are receiving this mail because:
You are the assignee for the bug.
You are watching all bug changes.