awesome-docs
diff --git a/‎README.md
+1-1 b/‎README.md
+1-1
diff --git a/‎client-go/4.sharedInformer.md renamed to ‎client-go/4.informer.md
+12-38 b/‎client-go/4.sharedInformer.md renamed to ‎client-go/4.informer.md
+12-38
diff --git a/‎client-go/6.sharedInformerFactory.md
+50 b/‎client-go/6.sharedInformerFactory.md
+50
@@ -1,3 +1,3 @@
 # kubernetes-dev-docs
 
-Kuberntes 开发文档
+Kubernetes 源码解析和实践
@@ -1,8 +1,8 @@
-# SharedInformer
+# Informer
 
 <!-- TOC -->
 
-- [SharedInformer](#sharedinformer)
+- [Informer](#informer)
     - [processorListener](#processorlistener)
         - [add() 方法](#add-方法)
         - [pop() 方法](#pop-方法)
@@ -21,11 +21,11 @@
         - [HandleDeltas() 方法](#handledeltas-方法)
     - [WaitForCacheSync() 函数](#waitforcachesync-函数)
     - [codegen 为特定资源类型创建的 SharedIndexInformer](#codegen-为特定资源类型创建的-sharedindexinformer)
-        - [SharedInformer 的使用场景](#sharedinformer-的使用场景)
-    - [GenericInformer 接口](#genericinformer-接口)
 
 <!-- /TOC -->
 
+Inforer 的主要使用场景是自定义 Controller，它需要从 apiserver List/Watch 特定类型的资源对象的所有事件，缓存到内存，供后续快速查找，根据事件类型，调用用户注册的回调函数。
+
 [前面分析了] (3.listwatch-reflector-controller.md) NewInformer()、NewIndexInformer() 函数使用 controller 的 Reflector List/Watch 特定资源类型的对象，缓存到本地，并调用用户设置的 OnAdd/OnUpdate/OnDelete 回调函数（保存在 ResourceEventHandler 中）。 
 
 这两个函数返回的 Store 和 Index 都缓存了从 apiserver List/Watch 更新的资源类型对象，并保持与 etcd 同步。另外，可以使用 Index 创建 Lister，进而更方便的从本地缓存中 List 和 Get 符合条件的资源对象。
@@ -38,6 +38,8 @@ SharedInformer 提供一个共享的对象缓存，并且可以将缓存中对
 
 SharedInformer 和 SharedIndexInformer 一般和 workqueue 同时使用,具体参考：[8.customize-controller.md](8.customize-controller.md)
 
+在分析 SharedInformer 和 SharedIndexInformer 之前，先分析它使用的 processorListener 和 sharedProcessor 结构类型。
+
 ## processorListener
 
 processorListener 封装了监听器处理函数 ResourceEventHandler 以及 RingGrowing 类型的循环队列。
@@ -307,9 +309,9 @@ type SharedInformer interface {
 	// GetStore returns the Store.
 	GetStore() Store
 	// GetController gives back a synthetic interface that "votes" to start the informer
-	GetController() Controller
-	// Run starts the shared informer, which will be stopped when stopCh is closed.
-	Run(stopCh <-chan struct{})
+	GetContrtarts the shared informer, which will be stopped when stopCh is closed.
+	Run(stopoller() Controller
+	// Run sCh <-chan struct{})
 	// HasSynced returns true if the shared informer's store has synced.
 	HasSynced() bool
 	// LastSyncResourceVersion is the resource version observed when last synced with the underlying
@@ -355,6 +357,8 @@ func NewSharedIndexInformer(lw ListerWatcher, objType runtime.Object, defaultEve
 
 + 传给 NewSharedIndexInformer () 的 indexers 一般是 `cache.Indexers{cache.NamespaceIndex: cache.MetaNamespaceIndexFunc}`，然后用 `DeletionHandlingMetaNamespaceKeyFunc` 作为对象的 KeyFunc 创建 Indexer 缓存；
 
+后文会介绍，一般情况下，我们不需要使用 NewSharedInformer() 和 NewSharedIndexInformer() 函数为特定资源类型创建 SharedInformer，而是使用 codegen 为特定资源类型创建的 NewXXXInformer() 和 NewFilteredXXXInformer() 函数来创建。
+
 ### 实现 SharedIndexInformer 接口的 sharedIndexInformer 类型
 
 这两个 Informer 包含：
@@ -773,6 +777,7 @@ func (f *deploymentInformer) Lister() v1.DeploymentLister {
 	return v1.NewDeploymentLister(f.Informer().GetIndexer())
 }
 ```
+
 + client 一般是 client-go 的 kubernets 或 CRD 的 clientset，如：
 
 	``` go
@@ -797,34 +802,3 @@ func (f *deploymentInformer) Lister() v1.DeploymentLister {
 
 一般情况下，我们不直接使用上面的 NewXXX 函数创建各资源类型的 SharedInformer，而是使用 codegen 生成的 sharedInformerFactory 来创建它们，具体参考：[6.sharedInformerFactory.md](6.sharedInformerFactory.md)
 
-### SharedInformer 的使用场景
-
-SharedInforer 的主要使用场景是自定义 Controller，它需要从 apiserver List/Watch 特定类型的资源对象的所有事件，缓存到内存，供后续快速查找，根据事件类型，调用用户注册的回调函数。
-
-## GenericInformer 接口
-
-``` go
-// 来源于 k8s.io/client-go/informers/generic.go
-type GenericInformer interface {
-	Informer() cache.SharedIndexInformer
-	Lister() cache.GenericLister
-}
-```
-
-内置类型 genericInformer 实现了该接口：
-
-``` go
-type genericInformer struct {
-	informer cache.SharedIndexInformer
-	resource schema.GroupResource
-}
-// Informer returns the SharedIndexInformer.
-func (f *genericInformer) Informer() cache.SharedIndexInformer {
-	return f.informer
-}
-
-// Lister returns the GenericLister.
-func (f *genericInformer) Lister() cache.GenericLister {
-	return cache.NewGenericLister(f.Informer().GetIndexer(), f.resource)
-}
-```
@@ -13,6 +13,7 @@
     - [使用 InformerFactory 创建特定资源类型的 SharedIndexInformer 过程分析](#使用-informerfactory-创建特定资源类型的-sharedindexinformer-过程分析)
         - [extensions informers](#extensions-informers)
         - [extensions v1beat1 informers](#extensions-v1beat1-informers)
+    - [GenericInformer 接口](#genericinformer-接口)
 
 <!-- /TOC -->
 
@@ -394,3 +395,52 @@ func (f *deploymentInformer) Lister() v1beta1.DeploymentLister {
 	return v1beta1.NewDeploymentLister(f.Informer().GetIndexer())
 }
 ```
+
+## GenericInformer 接口
+
+GenericInformer 接口封装了 SharedIndexInformer 接口，codegen 为各 K8S 资源类型生成的 XXXInformer（如上面的 DeploymentInformer） 均实现了该接口：
+
+``` go
+// 来源于 k8s.io/client-go/informers/generic.go
+type GenericInformer interface {
+	Informer() cache.SharedIndexInformer
+	Lister() cache.GenericLister
+}
+```
+
+内置类型 genericInformer 实现了该接口：
+
+``` go
+type genericInformer struct {
+	informer cache.SharedIndexInformer
+	resource schema.GroupResource
+}
+// Informer returns the SharedIndexInformer.
+func (f *genericInformer) Informer() cache.SharedIndexInformer {
+	return f.informer
+}
+
+// Lister returns the GenericLister.
+func (f *genericInformer) Lister() cache.GenericLister {
+	return cache.NewGenericLister(f.Informer().GetIndexer(), f.resource)
+}
+```
+
+一般情况下，我们可用通过以下两种方式创建 GenericInformer 接口：
+
+1. 直接使用 codegen 为各 K8S 资源类型生成的 XXXInformer；
+2. 或者使用 sharedInformerFactory 的 ForResource() 方法；
+
+
+``` go
+// 来源于 8s.io/client-go/informers/generic.go
+func (f *sharedInformerFactory) ForResource(resource schema.GroupVersionResource) (GenericInformer, error) {
+	switch resource {
+	...
+	// Group=extensions, Version=v1beta1
+	case extensionsv1beta1.SchemeGroupVersion.WithResource("deployments"):
+		return &genericInformer{resource: resource.GroupResource(), informer: f.Extensions().V1beta1().Deployments().Informer()}, nil
+	...
+	}
+}
+```
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`# kubernetes-dev-docs`
`2`	`2`
`3`		`-Kuberntes 开发文档`
	`3`	`+Kubernetes 源码解析和实践`