ethereum-oasis-op / eth1.x-JSON-RPC-API-standard

Other
11 stars 8 forks source link

Hosting of the JSON RPC API #8

Open samajammin opened 3 years ago

samajammin commented 3 years ago

Hey folks - lead developer of ethereum.org here - I'm looking to continue a conversation regarding the potential migration of where the JSON RPC docs are hosted: https://github.com/ethereum/eth-wiki/issues/55

I haven't heard back from @tkstanczak on that thread so opening this up here.

We (the ethereum.org team) have had ongoing discussions with community wikis that are no longer maintained (see https://github.com/ethereum/homestead-guide/issues/473 & https://github.com/ethereum/eth-wiki/issues/55) & we have buy-in to consolidate these resources by moving relevant pages onto ethereum.org. The hope here is to provide a more sustainable documentation solution given the team we have to maintain the content & our active community of GitHub contributors.

More context on our consolidation efforts can be found here: https://github.com/ethereum/ethereum-org-website/milestone/2

One of the primary pieces of content involved is the JSON RPC spec. Our current plan is to migrate that content to our developer docs & create a dedicated section of the site for Ethereum client developer resources.

That said, I'd be eager to hear input from this group to see if this interferes with any existing plans or how we may be able to collaborate on a solution here. Do you have a roadmap on where to ultimately provide documentation? We have plans on how to host & improve documentation around this but we welcome ideas & we're open alternative approaches.

Thanks in advance for your input!

tkstanczak commented 3 years ago

Hi @samajammin would you join us on Discord: https://discord.gg/Upvr757b

From my perspective it would be amazing to have an agreement that the spec will be constructed here, then converted into an EIP and then published via ethereum.org.

I would suggest the OASIS team to review whether this is an approved solution.

Also on the next call we can add this item to the agenda - to see if all teams are fine with storing the spec at ethereum.org.

@fjl ?

alcuadrado commented 3 years ago

Hi 👋

From my perspective it would be amazing to have an agreement that the spec will be constructed here, then converted into an EIP and then published via ethereum.org.

I agree with this, but also think that, in the meantime, moving the RPC "spec" from eth.wiki to ethereum.org would be valuable. Specially since the ethereum.org team will consolidate the different wikis there.

Hi @samajammin would you join us on Discord: https://discord.gg/Upvr757b

Is this a discord server to discuss this project? The invite has expired. I missed the last call, but would love to join the discord and the future calls.

fjl commented 3 years ago

I'd be really happy to have the spec on ethereum.org long term.

tkstanczak commented 3 years ago

@samajammin James Hancock on the Discord channel suggested that there is also a new Eth 1.x spec wiki that would like to be a o-host of the spec. Would be great if you could arrange consistency together?

actually, you already have reached out: https://github.com/ethereum-cat-herders/EIPIP/issues/48

MicahZoltu commented 3 years ago

https://github.com/ethereum/eth1.0-specs/ We could probably just have a folder in there for JSON-RPC.