[asterisk-bugs] [JIRA] (ASTERISK-22499) ARI documentation - point to HTTP server configuration sample and wiki docs where appropriate

[Matt Jordan (JIRA)]

    [ https://issues.asterisk.org/jira/browse/ASTERISK-22499?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=210218#comment-210218 ] 

Matt Jordan commented on ASTERISK-22499:
----------------------------------------

While I'm fine with this, the appropriate way to handle this is to actually tie this in with a <see-also> field. Right now, the DTD handles this for a <configObject>, but it won't actually show up until ASTERISK-22008 is worked.
                
> ARI documentation - point to HTTP server configuration sample and wiki docs where appropriate
> ---------------------------------------------------------------------------------------------
>
>                 Key: ASTERISK-22499
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-22499
>             Project: Asterisk
>          Issue Type: Improvement
>      Security Level: None
>          Components: Documentation
>    Affects Versions: SVN, 12.0.0-alpha1
>            Reporter: Rusty Newton
>            Assignee: Rusty Newton
>            Severity: Trivial
>
> This is something maybe obvious to an existing Asterisk user, but for someone new to Asterisk it would be helpful to explicitly state in ARI documentation where you configure the HTTP server it uses.
> From IRC:
> {noformat}
> <Pierri> Hi, I didn't find any mention on this page (https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Configuration_res_ari) on which web server ARI is going to exposed. In fewer words I don't know on which port it is going to be exposed.
> <file> it uses the built-in Asterisk HTTP server
> <Pierri> configured on "http.conf" right?
> <file> yes.
> <Pierri> Hmm... If I am not mistaken, this information is not on documentation. Maybe that could be made more explicit.
> <newtonr> Pierri, that is a good idea. I don't see anything obvious in the ARI documentation, so I'll create an issue in the tracker for it.
> {noformat}
> Perhaps we should add something in {{ari.conf}} and in the XML module help that would then show up here https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Configuration_res_ari and in the CLI.
> [Edit]
> Pierri added:
> {noformat}
> <Pierri> Please, if possible, include a note telling that ARI resources are made available under "http://asteriskurlhere/ari/". I think that isn't clear too.
> {noformat}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.asterisk.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira