fixes #29

remove title and description fom all markdown files. Make them explicit in text

Author: sliptonic

codeformatting/c++.md

@@ -1,12 +1,9 @@
 ---
-title: C++ Code Code Formatting Guidelines
-description:
-  Guidelines for code formatting in Python
 layout: default
 ---
 
-# {{page.title}}
+# C++ Code Code Formatting Guidelines
 
-{{page.description}}
+Guidelines for code formatting in Python
 
 Content goes here

codeformatting/index.md

@@ -1,13 +1,10 @@
 ---
-title: Code Formatting Guidelines
-description:
-  Guidelines for code formatting in C++ and Python
 layout: default
 ---
 
-# {{page.title}}
+# Code Formatting Guidelines
 
-{{page.description}}
+Guidelines for code formatting in C++ and Python
 
 FreeCAD is written primarily in C++ and Python (with a few files in other languages such as CMake). To smooth the process of merging new contributions it is desirable to minimize formatting changes to existing code, and to use a uniform code formatting style when writing new code. Eventually we expect to standardize the codebase on specific coding styles using Clang Format for C++ and a Python code-formatter (such as Black), but that is a work-in-progress and _should not_ be applied to existing otherwise-untouched code.
 

codeformatting/python.md

@@ -1,13 +1,10 @@
 ---
-title: Python Code Code Formatting Guidelines
-description:
-  Guidelines for code formatting in Python
 layout: default
 ---
 
-# {{page.title}}
+# Python Code Code Formatting Guidelines
 
-{{page.description}}
+Guidelines for code formatting in Python
 
 Use Black.
 

gettingstarted/index.md

@@ -1,12 +1,10 @@
 ---
-title: Getting Started
-description: Covers how to set up a build environment for contributing to FreeCAD
 layout: default
 ---
 
-# {{page.title}}
+# Getting Started
 
-{{page.description}}
+Covers how to set up a build environment for contributing to FreeCAD
 
 Working on FreeCAD is similar to working on may other open-source projects. This guide provides a short overview of the process. Much more information can be found at https://wiki.freecad.org.
 

maintainersguide/index.md

@@ -1,13 +1,11 @@
 ---
-title: Maintainers Guide
-description:
-  Guidelines for Maintainers regarding code review and merge procedures.
 layout: default
 ---
 
-# {{page.title}}
+# Maintainers Guide
+
+Guidelines for Maintainers regarding code review and merge procedures.
 
-{{page.description}}
 
 ## The role of a Maintainer
 

roadmap/index.md

@@ -1,13 +1,10 @@
 ---
-title: Roadmap
-description:
-   The roadmap provides broad objectives for the direction of FreeCAD development
 layout: default
 ---
 
-# {{page.title}}
+Roadmap
 
-{{page.description}}
+The roadmap provides broad objectives for the direction of FreeCAD development
 
 # Development Roadmap 1.0
 

stylebook/index.md

@@ -1,13 +1,10 @@
 ---
-title: Stylebook
-description:
-   The stylebook provides guidelines and explanations for visual elements in the FreeCAD application
 layout: default
 ---
 
-# {{page.title}}
+# Stylebook
 
-{{page.description}}
+The stylebook provides guidelines and explanations for visual elements in the FreeCAD application
 
 This book is meant to document the general style and conventions of the FreeCAD User Interface. Guidelines, terminology, and philosophies described here will be used to justify changes in the current UI in order to make the overall user experience more consistent, predictable, intuitive, and attractive in the future.
 

technical/SourceTreeBasics.md

@@ -1,13 +1,10 @@
 ---
-title: "Partial View of the FreeCAD Source Tree"
-description:
-    "A picture of the most commonly encountered branches of the tree."
 layout: default
 mermaid: true
 ---
-# {{page.title}}
+# "Partial View of the FreeCAD Source Tree"
 
-{{page.description}}
+"A picture of the most commonly encountered branches of the tree."
 
 {{page.mermaid}}
 

technical/TheApplicationModule.md

@@ -1,13 +1,11 @@
 ---
-title: "The Application Module"
-description:
-    "An overview of application module structure."
 layout: default
 mermaid: true
 ---
-# {{page.title}}
 
-{{page.description}}
+# "The Application Module"
+
+"An overview of application module structure."
 
 The functionality of FreeCAD is separated into Modules.  Some Modules are built into FreeCAD and some are Extension Modules (a form of plug-in).  Once installed, Extension Modules behave exactly as built-in Modules.
 

technical/developerglossary.md

@@ -1,12 +1,9 @@
 ---
-title: "Developer's Glossary"
-description:
-    "Some terms that a developer may run across."
 layout: default
 ---
-# {{page.title}}
+# "Developer's Glossary"
 
-{{page.description}}
+"Some terms that a developer may run across."
 
 Note that there may be subtle differences in how some terms are used by deveopers vs how they are used by users.