[haiku-bugs] Re: [Haiku] #17252: Move the User Guide into a new repository

  • From: "Haiku" <trac@xxxxxxxxxxxx>
  • To: undisclosed-recipients: ;
  • Date: Fri, 10 Sep 2021 00:42:22 -0000

#17252: Move the User Guide into a new repository
----------------------------+-------------------------
  Reporter:  jt15s          |      Owner:  nielx
      Type:  task           |     Status:  new
  Priority:  normal         |  Milestone:  Unscheduled
 Component:  Documentation  |    Version:
Resolution:                 |   Keywords:
Blocked By:                 |   Blocking:
  Platform:  All            |
----------------------------+-------------------------
Description changed by jt15s:

Old description:

The User Guide should be moved to a new subdomain such as userguide
.haiku-os.org to make it easier to remember.

New description:

 The User Guide should be moved to a new repo as discussed starting here
 https://github.com/haiku/website/pull/558#issuecomment-915697919
 The reasoning behind this (as outlined by PulkoMandy) is that each time
 Haiku is built, the user guide is also built with it. Thus, they are
 regenerated each time something in Haiku's source changes and that's why
 Software Update and pkgman have updates to the user guide so often.
 Building it separately (for example at haikuports) and versioning it
 independently would solve this issue.

 It would also solve the problem that sometimes people will try to submit
 change requests to fix problems in the userguide, and we have to redirect
 them to the userguide editor/translator tool instead.

 Additionally, it should be moved to a new subdomain such as userguide
 .haiku-os.org to make it easier to remember.

--
-- 
Ticket URL: <https://dev.haiku-os.org/ticket/17252#comment:5>
Haiku <https://dev.haiku-os.org>
The Haiku operating system.

Other related posts: