Fix #679, Add Markdown version of OSAL Configuration Guide

[ArielSAdamsNASA]

Describe the contribution
Pandoc was used to convert the OSAL Configuration Guide to a markdown file. During the conversion, issues were presented such as broken tables. Tables were fixed and block codes were added where appropriate.

Fix #679

Additional context
Please provide feedback on whether the markdown file is acceptable in terms of formatting.

Contributor Info - All information REQUIRED for consideration of pull request
Ariel Adams, ASRC Federal

[skliper]

@astrogeco @ArielSAdamsNASA - what's the status on this? It would help to move it forward...

[skliper]

Also delete the other versions... markdown only preferred.

[ArielSAdamsNASA]

@astrogeco @ArielSAdamsNASA - what's the status on this? It would help to move it forward...

@skliper Waiting on @acudmore for approval/feedback. I sent him an email this morning.

[skliper]

Related to #384, the issue to update the contents. A format check here should be sufficient (and will simplify fixing #384).

[astrogeco]

Mainly format cleanups. It might be worthwhile to do a find-and-replace on bold and italic syntax "***" which is sometimes used for subheadings in this document. Similarly horizontal rules "===" are also being used in a subheading fashion.

It might be worth passing this through a markdown linter like remark or prettier; there are Atom and VSCode plugins for to help with that.

[astrogeco]

Remove "markdown" from the file name and use git rm to remove the pdf and doc versions of the guide.

[ArielSAdamsNASA]

I removed the pdf and doc versions of the guide and updated the markdown version.

For the markdown version:

• Removed the front matter, so the Introduction is the first section
• Updated headers to use the markdown syntax # and removed horizontal rule for headers
• Updated table headers to use fourth-level headers
• Use a code block for the section starting with $ sparc-rtems4.10-gdb tasking-example.nxe
• Moved Revision History to the bottom of the page for now

[ghost]

The conversion is good, there are a couple of table format issues ( in the glossary for example ). But this conversion and removing the old documents is the first step, I think the doc needs to be overhauled in content after this conversion. Much of the technical info is out of date.

[astrogeco]

Looks good! I would do an interactive rebase and squash the table fix into the original md commit. Also edit the commit message to use the format "Fix #XYZ, COMMIT_DESCRIPTION".

Once ready click "ready for review" to remove the PR's draft status. Finally add the CCB-READY label

[astrogeco]

CCB 2020-12-16 APPROVED

• Separate issue for content: Update OSAL Configuration Guide, build instructions, directory references, etc #384