[bact]

The intention of this PR is to allow more contributors to test the spec and spot issues early.
It will also allow more people to understand the build process which involved components across several spdx repos.

• Add info on repo structure (which directory is for what purpose)
• Update build instructions
  • Add a build flow diagram and instruction on using spdx-3-model, spdx-spec, and spec-parser together
  • Add info about MkDocs configuration
  • Add info about mike and GitHub workflow
• Update info about development branch and repo
  • Was pointing to https://github.com/spdx/spdx-spec/tree/master/chapters which is no longer exist

This is a rework of #946

Note: Once we are set on internationalization/localization, this will need to be updated again.

[bact]

@JPEWdev if you have time to review this again. (I have removed the ontology/ directory from the repo structure already).

[zvr]

I don't think build and website deployment instructions belong in the repo top-level README file, but maybe it's just me...

[goneall]

LGTM

[goneall]

I don't think build and website deployment instructions belong in the repo top-level README file, but maybe it's just me...

We discussed on the tech and agreed that there is enough improvements here that we should go ahead and merge. We can decide later to split this out into a separate README and create a separate follow-on PR.