[GitHub] guacamole-manual pull request #87: GUACAMOLE-38: Add chapter for Quickconnec...

[mike-jumper <gi...@git.apache.org>]

Github user mike-jumper commented on a diff in the pull request:

    https://github.com/apache/guacamole-manual/pull/87#discussion_r194235479
  
    --- Diff: src/chapters/quickconnect.xml ---
    @@ -0,0 +1,90 @@
    +<?xml version="1.0" encoding="UTF-8"?>
    +
    +<chapter xml:id="quickconnect" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en"
    +    xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink">
    +    <title>Quickconnect extension</title>
    --- End diff --
    
    Should the title represent more the high-level goal satisfied by the extension, rather than the extension itself? I don't have a suggestion for this off the top of my head, but from the perspective of a user browsing the table of contents for help, they presumably wouldn't know that the solution to their problem is the quickconnect extension until they read the chapter in question.
    
    This is the reasoning behind the existing chapters being named things like "Database authentication" rather than "JDBC extension", or "Proxying Guacamole" rather than "Apache and Nginx".


---