oasisprotocol / old-docs

Oasis platform documentation
https://docs.oasis.dev
Apache License 2.0
0 stars 8 forks source link

Update architecture-overview.md #284

Open jcueto opened 4 years ago

jcueto commented 4 years ago

Added some grammatical and syntactical changes to the Architecture Overview file.

I also think the term Paratime should be used in the same way that Polkadot uses Parachain. That is, the T in Time should not be capitalized, since the T in runtime is not capitalized either. Thus, we can refer to the Paratime concept as a proper noun and then when discussing various paratimes we can use it in the lower case.

Is there any reason why we call it the Oasis Runtime instead of Oasis Paratime? If we are going to develop a new terminology, we should aim to use it consistently.

armiller123 commented 4 years ago

@jcueto these edits look great.

Chatted with Anne. Let's keep ParaTime as is. We can still reference it as a proper noun.

As far as ParaTime vs runtime, this is a bit tricky. Will ping you offline. Runtime is a valuable descriptive term, that being said, I agree with your thinking that we should try to promote our branded term if we can.

Afauvre commented 4 years ago

@jcueto can we get this PR finalized tomorrow?

jcueto commented 4 years ago

@armiller123 what is missing for this commit to go through?

armiller123 commented 4 years ago

@jcueto just need to update the Paratime >> ParaTime to stay consistent with other docs then it should be gtg

jcueto commented 4 years ago

@armiller123 updated wording to ParaTime - please take a look