Update overwrite markdown

specs/Cat.CalculateFood.md

@@ -0,0 +1,17 @@
+---
+uid: CatLibrary.Cat`2.CalculateFood(System.DateTime)
+name: "Override CalculateFood Name"
+summary: "It's an overridden summary in `markdown` format"
+syntax:
+    parameters:
+    - id: date
+      description: "This is overridden description for a parameter. `id` must be specified."
+    return:
+      type: System.Collections.Generic.Dictionary{System.String,System.Collections.Generic.List{System.Int32}}
+      description: "It's overridden description for return. `type` must be specified."
+exceptions:
+  - type: System.ArgumentException
+    description: "This is an `overridden` argument exception. you can add additional exception by adding different exception `type`."
+---
+
+This is overriding methods. You can override parameter descriptions for methods, you can even add exceptions to methods. Check the intermediate `obj` folder to see the data model of the generated method/class. Override Yaml header should follow the data structure.

specs/Cat.md

@@ -10,28 +10,3 @@ This is a class talking about [CAT](https://en.wikipedia.org/wiki/Cat).
 >
 
 Refer to @CatLibrary.IAnimal to see other animals.
-
----
-uid: CatLibrary.IAnimal
-remarks: '*THIS* is remarks overridden in *MARKDWON* file'
----
-
-### Welcome to the **Animal** world!
-
----
-uid: CatLibrary.Cat`2.CalculateFood(System.DateTime)
-name: "Override CalculateFood Name"
-summary: "It's an overridden summary in `markdown` format"
-syntax:
-    parameters:
-    - id: date
-      description: "This is overridden description for a parameter. `id` must be specified."
-    return:
-      type: System.Collections.Generic.Dictionary{System.String,System.Collections.Generic.List{System.Int32}}
-      description: "It's overridden description for return. `type` must be specified."
-exceptions:
-  - type: System.ArgumentException
-    description: "This is an `overridden` argument exception. you can add additional exception by adding different exception `type`."
----
-
-This is overriding methods. You can override parameter descriptions for methods, you can even add exceptions to methods. Check the intermediate `obj` folder to see the data model of the generated method/class. Override Yaml header should follow the data structure.

specs/CatLibrary.IAnimal.md

@@ -0,0 +1,6 @@
+---
+uid: CatLibrary.IAnimal
+remarks: '*THIS* is remarks overridden in *MARKDWON* file'
+---
+
+### Welcome to the **Animal** world!

specs/petstore-operations.addPet.footer.md

@@ -0,0 +1,5 @@
+---
+uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0/addPet
+footer: *content
+---
+> NOTE: Add pet only when you needs.

specs/petstore-operations.footer.md

@@ -0,0 +1,11 @@
+---
+uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0
+title: Pet Store APIs
+footer: *content
+---
+
+### See Alsos
+
+See other REST APIs:
+* [Contacts API](../restapi/contacts_swagger2.json)
+

specs/petstore-operations.md

@@ -4,33 +4,3 @@ title: Pet Store APIs
 ---
 
 Describe APIs in Pet Store
-
----
-uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0
-title: Pet Store APIs
-footer: *content
----
-
-### See Alsos
-
-See other REST APIs:
-* [Contacts API](../restapi/contacts_swagger2.json)
-
----
-uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0/addPet
-footer: *content
----
-> NOTE: Add pet only when you needs.
-
----
-uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0/tag/pet
-description: *content
----
-
-Description for pet tag
-
----
-uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0/tag/store
----
-
-Additional description for store tag

specs/petstore-operations.tag.pet.md

@@ -0,0 +1,6 @@
+---
+uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0/tag/pet
+description: *content
+---
+
+Description for pet tag

specs/petstore-operations.tag.store.md

@@ -0,0 +1,5 @@
+---
+uid: petstore.swagger.io/v2/Swagger Petstore/1.0.0/tag/store
+---
+
+Additional description for store tag