Merge pull request #23 from Hsn723/master

Update documentation

Author: ymmt2005

README.md

@@ -35,7 +35,7 @@ Visit the docs on [godoc.org][godoc].
 
 [kintone]: https://www.kintone.com/
 [APIen]: https://developer.kintone.io/hc/en-us
-[APIja]: https://cybozudev.zendesk.com/hc/ja
+[APIja]: https://developer.cybozu.io/hc/ja
 [bsd2]: http://opensource.org/licenses/BSD-2-Clause
 [godoc]: http://godoc.org/github.com/kintone/go-kintone
 

app.go

@@ -72,14 +72,19 @@ func (f UpdateKey) MarshalJSON() ([]byte, error) {
 // App provides kintone application API client.
 //
 // You need to provide Domain, User, Password, and AppId.
-// You can also use the api token instead of user/password.
-// When using Google AppEngine, you must supply Client too.
+// You can also use an API token instead of user/password.
+// If you require specialized client settings, for instance
+// need to specify a client certificate, proxy settings, or
+// are using Google AppEngine, you can build an *http.Client
+// instance and supply it to Client.
+//
+// ex: Google AppEngine
 //
 //	import (
 //		"appengine"
 //		"appengine/urlfetch"
 //		"github.com/kintone/go-kintone"
-//		"http"
+//		"net/http"
 //	)
 //
 //	func handler(w http.ResponseWriter, r *http.Request) {
@@ -88,6 +93,22 @@ func (f UpdateKey) MarshalJSON() ([]byte, error) {
 //		...
 //	}
 //
+// ex: proxy
+//
+//	import (
+//		"net/http"
+//		"net/url"
+//		"github.com/kintone/go-kintone"
+//	)
+//
+//	func main() {
+//		proxyURL, _ := url.Parse("https://proxy.example.com")
+//		transport := &http.Transport{Proxy: http.ProxyURL(proxyURL)}
+//		client := &http.Client(Transport: transport)
+//		app := &kintone.App{Client: client}
+//		...
+//	}
+//
 // Errors returned by the methods of App may be one of *AppError,
 // ErrTimeout, ErrInvalidResponse, or ErrTooMany.
 type App struct {

doc.go

@@ -1,7 +1,7 @@
 /*
 Package kintone provides interfaces for kintone REST API.
 
-See http://developers.kintone.com/ for API specs.
+See https://developer.kintone.io for API specs.
 
 	import (
 		"log"