fix: always show the GitHub endpoint selection

so users are aware that they must add a new endpoint in configuration

Standardize the docs for apiUri

Author: carlossg

src/main/java/org/jenkinsci/plugins/github_branch_source/GitHubAppCredentials.java

@@ -799,6 +799,7 @@ public String getIconClassName() {
         }
 
         @SuppressWarnings("unused") // jelly
+        @Deprecated
         public boolean isApiUriSelectable() {
             return !GitHubConfiguration.get().getEndpoints().isEmpty();
         }

src/main/java/org/jenkinsci/plugins/github_branch_source/GitHubSCMNavigator.java

@@ -1868,6 +1868,7 @@ static ListBoxModel getPossibleApiUriItems() {
          * @return {@code true} if there is more than one GitHub endpoint configured.
          */
         @SuppressWarnings("unused") // jelly
+        @Deprecated
         public boolean isApiUriSelectable() {
             return !GitHubConfiguration.get().getEndpoints().isEmpty();
         }

src/main/java/org/jenkinsci/plugins/github_branch_source/GitHubSCMSource.java

@@ -2249,6 +2249,7 @@ public ListBoxModel doFillApiUriItems() {
             return result;
         }
 
+        @Deprecated
         public boolean isApiUriSelectable() {
             return !GitHubConfiguration.get().getEndpoints().isEmpty();
         }

src/main/resources/org/jenkinsci/plugins/github_branch_source/GitHubAppCredentials/config.jelly

@@ -5,16 +5,9 @@
     <f:textbox/>
   </f:entry>
   <j:choose>
-    <j:when test="${descriptor.apiUriSelectable}">
-      <f:entry title="${%API endpoint}" field="apiUri">
-        <f:select/>
-      </f:entry>
-    </j:when>
-    <j:otherwise>
-      <f:invisibleEntry>
-        <f:select field="apiUri"/>
-      </f:invisibleEntry>
-    </j:otherwise>
+    <f:entry title="${%API endpoint}" field="apiUri">
+      <f:select/>
+    </f:entry>
   </j:choose>
 
   <f:entry title="${%Key}" field="privateKey">

src/main/resources/org/jenkinsci/plugins/github_branch_source/GitHubAppCredentials/help-apiUri.html

@@ -1,3 +1,4 @@
 <p>
     <a href="https://developer.github.com/v3/">GitHub API</a> endpoint such as <code>https://github.example.com/api/v3/</code>.
+    The list of servers is configured in the <strong>Manage Jenkins » Configure System » GitHub Enterprise Servers</strong> screen.
 </p>

src/main/resources/org/jenkinsci/plugins/github_branch_source/GitHubSCMNavigator/config.jelly

@@ -1,18 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?jelly escape-by-default='true'?>
 <j:jelly xmlns:j="jelly:core" xmlns:f="/lib/form" xmlns:c="/lib/credentials" xmlns:scm="/jenkins/scm/api/form">
-  <j:choose>
-    <j:when test="${descriptor.apiUriSelectable}">
-      <f:entry title="${%API endpoint}" field="apiUri">
-        <f:select/>
-      </f:entry>
-    </j:when>
-    <j:otherwise>
-      <f:entry title="${%API endpoint}" field="apiUri">
-        <f:textbox readonly="readonly"/>
-      </f:entry>
-    </j:otherwise>
-  </j:choose>
+  <f:entry title="${%API endpoint}" field="apiUri">
+    <f:select/>
+  </f:entry>
   <f:entry title="${%Credentials}" field="credentialsId">
     <c:select checkMethod="post"/>
   </f:entry>

src/main/resources/org/jenkinsci/plugins/github_branch_source/GitHubSCMNavigator/help-apiUri.html

@@ -1,4 +1,4 @@
 <div>
-    The server to connect to. The list of servers is configured in the <strong>Manage Jenkins » Configure
-    System » GitHub Enterprise Servers</strong> screen.
+    <a href="https://developer.github.com/v3/">GitHub API</a> endpoint such as <code>https://github.example.com/api/v3/</code>.
+    The list of servers is configured in the <strong>Manage Jenkins » Configure System » GitHub Enterprise Servers</strong> screen.
 </div>

src/main/resources/org/jenkinsci/plugins/github_branch_source/GitHubSCMSource/config-detail.jelly

@@ -22,13 +22,9 @@
   </f:radioBlock>
   <f:radioBlock name="configuredByUrlRadio" value="false" checked="false" title="${%Repository Scan - Deprecated Visualization}" inline="true">
     <f:nested>
-      <j:choose>
-        <j:when test="${descriptor.apiUriSelectable}">
-        <f:entry title="${%API endpoint}" field="apiUri">
-          <f:select/>
-        </f:entry>
-        </j:when>
-      </j:choose>
+      <f:entry title="${%API endpoint}" field="apiUri">
+        <f:select/>
+      </f:entry>
       <f:entry title ="${%Owner}" field="repoOwner">
         <f:textbox/>
       </f:entry>

src/main/resources/org/jenkinsci/plugins/github_branch_source/GitHubSCMSource/help-apiUri.html

@@ -1,4 +1,4 @@
 <div>
-    The server to connect to. The list of servers is configured in the <strong>Manage Jenkins » Configure
-    System » GitHub Enterprise Servers</strong> screen.
+    <a href="https://developer.github.com/v3/">GitHub API</a> endpoint such as <code>https://github.example.com/api/v3/</code>.
+    The list of servers is configured in the <strong>Manage Jenkins » Configure System » GitHub Enterprise Servers</strong> screen.
 </div>