Bug 1204982

Move and clean up documentation in zanata-server wiki to zanata.readthedocs.org.
 
The idea is to allow users/dev/maintainer can easily access to all our documentations which is currently hosted in multiple location.

Reorganising the documentation structure for user guides on Zanata.org/help and zanata.readthedocs.org.

- Update to latest information
- Update screen shots

The outline I have in mind is 

# Welcome 
Page layout explanation
- Projects
- Groups
- Languages
- Glossary
- Dashboard

User guide
1. Registration
  1.1 register to Zanata
  1.2 activate your account
  1.3 resend activation email

2. Account settings

3. Project maintainers guide
  3.1 Creating project in Zanata

    3.1.1 project settings
    3.1.2 language settings
    3.1.3 translation settings (validation and copyTrans settings)
    3.1.3 permission and roles
    3.1.4 webhook setup

  3.2 Creating new version in Zanata
    3.2.1 Copy an existing version
    3.2.2 version settings
    3.2.3 version type
    3.2.4 language settings
    3.2.5 translation settings (validation settings)
    3.2.6 Merge translations from existing version into this.

  3.3 Uploading your project

    3.3.1 Using browser
      2.3.1.1 Uploading source documents
      2.3.1.2 Uploading translations

    3.3.2 Using Zanata-Cli
      2.3.2.1 Install/setup zanata-cli for your project
      2.3.2.2 Uploading source documents
      2.3.2.3 Uploading translations

  3.4 Downloading your project
    3.4.1 Using browser
    3.4.2 Using zanata-cli
  
  3.5 Joining a group (refer to group section)

  3.6 Statistics of your project translation
    {UI statistic} and {REST API statistic}

4. Translator guide 
  4.1 Joining language team (reviewer and translation role explanation)
  4.2 Translating a document (refer to features in editor for more info)
  4.3 Reviewing translations (refer to features in editor for more info)

5. Group maintainer guide
 5.1 Creating group(need admin role)
 5.2 General Settings
 5.3 Language settings
 5.4 permission and roles
 5.5 Adding project-version

6. Language coordinator guide
  6.1 permission and roles
  6.2 Requesting new language for Zanata
  6.3 Adding team member
  6.4 Removing team member
  6.4 Update team member's role

5. Features in editor
 5.1 Layout explanation
 5.2 Editor
  5.2.1 Settings (all settings of right panel)
  5.2.2 Keyboard shortcut
  5.2.3 Concurrent editing
  5.2.4 Translation memory
    5.2.4.1 TM merge
  5.2.5 Glossary
 5.3 Project-wide search and replace
  {steps for search and replace}

6. REST API documentation
  everything in https://zanata.ci.cloudbees.com/job/zanata-api-site/site/zanata-common-api/rest-api-docs/index.html 


7. Glossary
 7.1 permission and role
 7.2 uploading glossary
 7.3 deleting glossary


8. Contacting 
  - Zanata admin
  - Language coordinator

9. TMX import/export

Still more documentation to come

Newer outline update:

Search
Common Questions
- All questions
- Ask a question
Guides
- Zanata Basics
  - Maintainer
  - Translators
- How to…
  - Translate a javascript project
  - Translate a HTML file in Zanata
Terminology
Accounts
Feeds
Notifications
Projects
Versions
Documents
Languages
Groups
Glossary
Search
Editor
Command Line Tools
Permissions
Statistics
Translation
Reviews
Translation Memory
Integrations
Keyboard Shortcuts
Tips & Tricks
- e.g. Jump to a user profile with search
- e.g. Get back to your last translation from the dashboard
- Should be short videos, but obvious from the title
API
- Authentication
- How to use
- Link to docs
- e.g. 
- https://stripe.com/docs/api
Administration
Installation
Contact Us
- Email
- IRC
- Mailing Lists
- Twitter

1. Populate the contents for user guides 
2. Update latest information
3. Check all the links if its valid on zanata.org/help
4. Add a way for users to discover the readthedocs from zanata.org/help
5. Request for sub domain : docs.zanata.org

Broken links:

I just ran http://www.brokenlinkcheck.com for zanata.org and it flagged the following links as giving 404

In http://zanata.org/blog/

 - http://zanata.org/blog/configuration/jms-messaging
 - http://zanata.org/docs/Zanata_Release_Notes_1.5/html/index.html
 - http://zanata.org/developers.html


In http://zanata.org/zanata-version-3-6/

 - http://zanata.org/zanata-version-3-6/configuration/jms-messaging

In http://zanata.org/help/copytrans-explained/

 - http://zanata.org/help/reuse/copytrans-use

(In reply to Michelle Kim from comment #6)
> 1. Populate the contents for user guides
Done

> 2. Update latest information
Done

> 3. Check all the links if its valid on zanata.org/help
Not done

> 4. Add a way for users to discover the readthedocs from zanata.org/help
Not done
A link from zanata.org/help is fine until we decide whether to use a redirect.

> 5. Request for sub domain : docs.zanata.org
Done

> 3. Check all the links if its valid on zanata.org/help
> 4. Add a way for users to discover the readthedocs from zanata.org/help
PR: 

https://github.com/zanata/zanata.github.io/pull/21
https://github.com/zanata/zanata-server/pull/807

Verified. Links are working and available from zanata.org/help

Hi, 

Thanks for adding the links to readthedocs from zanata.org/help is working.

However, I did random test of the broken link from zanata.org/help and the link seems still broken as follows:

From this page, http://zanata.org/help/create-project/

"There is a brief description for each project type next to each project type option. If the description is insufficient, more information on each project type is available at Project Types help page."

When I click the link to Project Types Help Page, below link shows up with following messages:
http://zanata.readthedocs.org/en/latest/user-guide/project-types/


You've found something that doesn't exist.

What are you looking for?

Go to the top of the documentation.


        \          SORRY            /
         \                         /
          \    This page does     /
           ]   not exist yet.    [    ,'|
           ]                     [   /  |
           ]___               ___[ ,'   |
           ]  ]\             /[  [ |:   |
           ]  ] \           / [  [ |:   |
           ]  ]  ]         [  [  [ |:   |
           ]  ]  ]__     __[  [  [ |:   |
           ]  ]  ] ]\ _ /[ [  [  [ |:   |
           ]  ]  ] ] (#) [ [  [  [ :===='
           ]  ]  ]_].nHn.[_[  [  [
           ]  ]  ]  HHHHH. [  [  [
           ]  ] /   `HH("N  \ [  [
           ]__]/     HHH  "  \[__[
           ]         NNN         [
           ]         N/"         [
           ]         N H         [
          /          N            \
         /           q,            \
        /                           \



I would like to request thorough check of the broken links again from zanata.org/help 

Thanks,
Michelle

I checked directly from the readthedocs page and it seems the valid link is 

http://zanata.readthedocs.org/en/latest/user-guide/projects/project-types/

However the zanata.org/help page redirects it to 

http://zanata.readthedocs.org/en/latest/user-guide/project-types/



So the redirect link from zanata.org/help page : 

http://zanata.readthedocs.org/en/latest/user-guide/project-types/ should be changed to 
http://zanata.readthedocs.org/en/latest/user-guide/projects/project-types/

Another broken link I just found:

From this page, 
http://zanata.org/help/cli-configuration/

You can customize zanata.xml with command hooks so that other tools will automatically run before or after Zanata commands. Read about command hooks at the command hook page on the wiki.

Command hook page on the wiki is no longer valid :

https://github.com/zanata/zanata-server/wiki/Client-Command-Hooks

Since we have most up-to-date information on readthedocs, we should find a way to redirect the zanata.org/help contents to the new docs site in the near future.

Michelle, 

Thanks for checking the links. 



PR for broken link:
https://github.com/zanata/zanata.github.io/pull/24

Verified (multiple commits/repos)