Merge pull request #51 from UMLCloudComputing/docsupdate

feat: Improve project documentation structure and guidelines

Author: yyualvin

README.md

@@ -139,26 +139,14 @@ To add a new project's documentation onto the project docs section of the websit
                 └── intro.md | Introduction/
                     _category_.json
     ```
-3. The project's documentation files must follow [Docusaurus's](https://docusaurus.io/docs/create-doc) doc creation guidelines. <br/> This includes having proper front-matter and an appropriate `_category_.json` file for each folder. 
-
-Front Matter requirements:
-1. All markdown files must have the following front-matter: (`#` is an integer)
+3. The project's documentation files must follow [Docusaurus's](https://docusaurus.io/docs/create-doc) doc creation guidelines. <br/> The `_category_.json` file is autogenerated at website build time. The order in which the projects are displayed on the website is determined by the order in which the projects are listed in the `repos.json` file (top to bottom order).
+4. Front Matter requirements: All markdown files must have the following front-matter: (`#` is an integer). This will affect the order in which the doc pages are displayed on the website (top to bottom order). 
 ``` text
 ---
 sidebar_position: #
 ---
 ```
 
-2. Each folder and subfolder must contain a `_category_.json` file. Each `.json` file should be contain the following content:
-``` json
-{
-    "label": "My Project",
-    "position": #,
-    "link": {
-        "type": "generated-index"
-    }
-}
-```
 Here the label should be your own. The label indicates the labeled name of the folder or subfolder to be shown. IE project name (`My Project`), subsection name (`Excersices`), etc. <br/>
 The position value should also be customized to an `integer` representing the position of your folder or subfolder relative to other subfolders. 
 
@@ -174,8 +162,6 @@ react-mui-resume
 │   └── Intro.md
 ```
 
-
-
 ### In order to add your project:
 1. Create a new branch from the **main** branch
 2. Name the branch with the following convention: `feat: Add new project docs: PROJECTNAME` with `PROJECTNAME` being the name of your project.