On Fri, 2014-10-31 at 02:52 -0700, Paul Fee wrote:
> Hi Stephen,
>
> Thanks for the feedback, it's encouraging to see that some of the
> items could be automated and I appreciate that others will remain
> manual steps for the reasons you've stated.
>
> In the mean time, should we enhance the ReviewBoard documentation so
> that it lists the steps necessary to go from a fresh OS install up to
> a working ReviewBoard site? The current page lacks some of the steps
> I've detailed.
>
> https://www.reviewboard.org/docs/manual/2.0/admin/installation/linux/
>
> The current page mixes generic steps with distro specific information,
> which may confuse new users as they try to figure out which steps to
> apply and which to skip. Despite the risk of duplicating information,
> I think it might be clearer and more concise if we had a separate page
> for RHEL/CentOS/Fedora installation. Similar pages could be
> constructed for other distros.
>
> If this seems reasonable, then how do we go about updating those
> pages? What format are the pages written in?
>
The documents are formatted with ReStructuredText (RST)[1] and are kept
in the git repository with the rest of the code[2].
> The longer term aim is that over time as some of the steps get
> incorporated in the distro packages or within rb-site install, then
> the manual install steps will shrink.
[1]
http://docutils.sourceforge.net/rst.html
[2]
https://github.com/reviewboard/reviewboard/tree/master/docs/manual/admin/installation
--
Get the Review Board Power Pack at http://www.reviewboard.org/powerpack/
---
Sign up for Review Board hosting at RBCommons: https://rbcommons.com/
---
Happy user? Let us know at http://www.reviewboard.org/users/
---
You received this message because you are subscribed to the Google Groups
"reviewboard" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/d/optout.
