Description of problem: A few things to look at: - Check for prerequisites or important conceptual or reference material - Review for style and consistency - Identify and fix any factual errors, incorrect paths, etc. - Identify any missing steps or other info that would prevent a successful installation. Version-Release number of selected component (if applicable): Expected results: - Writing style consistent with Red Hat Style Guide as much as possible (Zanata is a community project and some variations are acceptable) - No factual errors - No missing information - No broken links Additional info: This bug may end up being a tracker for smaller bugs on this page.
Hi, Just couple of things: In section Prerequisites: How about adding: Database such as MySQL (which is not included in the zip) Database java connector (mysql-java-connector) (which is included in the zip). There are several optional packages: 1. clamav for antivirus 2. Fonts for CAPTCHA and server monitoring diagrams. In section "Configuring Zanata", item 4, do you think showing the whole tag more readable? e.g. <simple name="java:global/zanata/email/default-from-address" value="admin"/> In section "Configuring Zanata", item 5, besides the format suggested in earlier paragraph, in FireFox it looks like: java:global/zanata/smtp/host java:global/zanata/smtp/port java:global/zanata/smtp/username java:global/zanata/smtp/password java:global/zanata/smtp/tls java:global/zanata/smtp/ssl Which is not very readable. In Section Starting the Zanata Server: If cwd is not <ZANATA DIR>/bin/, then it won't work. Instead, use following command: cd <ZANATA DIR>/bin; ./start-zanata.sh Regards,
b3103eb..96eadeb master -> master Includes all of the above fixes, but I wasn't sure what to do about the Windows version "start-zanata". Does that require similar treatment? thanks for the review. David
(In reply to David O'Brien from comment #2) > b3103eb..96eadeb master -> master > > Includes all of the above fixes, but I wasn't sure what to do about the > Windows version "start-zanata". Does that require similar treatment? Yes. it would be cd <ZANATA DIR>\bin start-zanata.bat Oh, I forget to mention: In Configuring Zanata, item 5 Those properties are included standalone.xml. You need to add them between: <subsystem xmlns="urn:jboss:domain:naming:1.3"> <bindings> .... </bindings> </subsystem> The same place that you put <simple name="java:global/zanata/security/admin-users" value="admin"/> and <simple name="java:global/zanata/email/default-from-address" value="admin"/> Regards
Updated documentation for downloads: http://docs.zanata.org/en/latest/user-guide/systemadmin/configuration/installation/index.html I think all the instructions in zanata.org/download should move to http://docs.zanata.org/en/latest/user-guide/systemadmin/configuration/installation/index.html and have just download links of various version of Zanata package.
Pull request: https://github.com/zanata/zanata.github.io/pull/25
"Verified" at bf0cc1cb54b30648f520fbfcaffa3631dad52945