unity-sds / unity-architecture

Location to discuss the unity architecture in the public domain
Apache License 2.0
2 stars 3 forks source link

Proposed README.md file using standardized template #16

Closed riverma closed 2 years ago

riverma commented 2 years ago

Purpose

riverma commented 2 years ago

i like the consistent readme pages, but the quickstart, requiement, setup, usage, etc seem... out of place for an architecture document.

@mike-gangl - I can trim the README to remove unnecessary sections (and just FYI you have commit access to the PR branch as well by default, just click the riverma-readme branch and modify the README.md in the GitHub editor, and commit - the changes will show up here. However, isn't there a build process for generating the HTML versions of your C4 diagrams? Say if someone wanted to contribute a change to the proposed architecture, how would they locally test to ensure it works with your setup? I think that's what the Quick Start is all about in my mind. What do you think?

Also, if the README is missing any key sections you think, let me know.

I wonder if there should be a more general 'unity' landing page, or like you mentioned previously, if this is the one we'll use as the standard. That would make sense with the bug reports, etc.

A centralized webpage / landing-page is a great idea. Let me mark that as a to-do for Q3? We can update all the repo READMEs to point to that once its up?

riverma commented 2 years ago

@mike-gangl - I've updated the PR for this to be ready-to-merge upon your review. I just set a couple things to TBD that can be filled out later, and cleaned up the unnecessary parts of this readme.

Please see demo at: https://github.com/riverma/unity-architecture/tree/riverma-readme