cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andrey Kurdyumov (JIRA)" <j...@apache.org>
Subject [jira] [Issue Comment Deleted] (CB-7369) Ridiculous link loop in documentation. Getting started is a headache
Date Sun, 18 Jan 2015 09:23:34 GMT

     [ https://issues.apache.org/jira/browse/CB-7369?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Andrey Kurdyumov updated CB-7369:
---------------------------------
    Comment: was deleted

(was: See:
http://cordova.apache.org/docs/en/edge/guide_overview_index.md.html#Overview_development_paths

Inside the "Cross-platform (CLI) workflow" subsection of section "Development Paths", there
link "The Command-Line Interface". It point to the same page, and not on the 
http://cordova.apache.org/docs/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface.)

> Ridiculous link loop in documentation. Getting started is a headache
> --------------------------------------------------------------------
>
>                 Key: CB-7369
>                 URL: https://issues.apache.org/jira/browse/CB-7369
>             Project: Apache Cordova
>          Issue Type: Bug
>          Components: Docs
>         Environment: all
>            Reporter: teo
>            Priority: Critical
>
> I approach Cordova as a newcomer and look for a "getting started" kind of guide.
> So I start at http://cordova.apache.org/ and I notice a link to documentation, which
allegedly "includes Getting Started guides":
> http://cordova.apache.org/docs/en/3.5.0/
> Here I look for the words "Getting Started" and find nothing, but there's an promising
"Overview"  which reads:
> "START HERE if you are new to Cordova. Includes installation and next steps." (emphasys
added)
> So I follow that link:
> http://cordova.apache.org/docs/en/3.5.0/guide_overview_index.md.html#Overview
> And at the bottom it says:
> """
> Installing Cordova
> The installation of Cordova will differ depending on the workflow above you choose:
> Cross-platform workflow: see The Command-Line Interface.
> Platform-centered workflow: see the Platform Guides.
> """
> I want to choose the "platform-centered workflow", so I follow the link to Platform Guides:
> http://cordova.apache.org/docs/en/3.5.0/guide_platforms_index.md.html#Platform%20Guides
> which says:
> """
> Platform Guides
> BEFORE developing for any of the platforms listed below, install cordova's command-line
interface (CLI). (For details, see The Command-Line Interface.)
> """
> (emphasys added). So I follow that link:
> http://cordova.apache.org/docs/en/3.5.0/guide_cli_index.md.html#The%20Command-Line%20Interface
> And it says:
> """
> PREREQUISITES
> BEFORE running any command-line tools, you need to install SDKs for each platform you
wish to target. (See the Platform Guides for more details.)
> """
> which links back to the platform guides.
> LOOP DETECTED!
> There needs to be a clearer step-by-step installation guide (one for each platform or
workflow, if needed), without a loop of prerequisites where installing A is required before
you install B, but installing B is required before you install A.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org


Mime
View raw message