icerpc / icerpc-docs

Documentation site for IceRPC
https://docs.icerpc.dev
Other
7 stars 6 forks source link

Add protobuf tutorials #397

Closed pepone closed 11 months ago

pepone commented 11 months ago

This PR adds Protobuf tutorials, fixes #387

ReeceHumphreys commented 11 months ago

I think that the Slice tutorial should go first here. Also I think it does seem a bit cluttered and hard to parse since the titles are so similar. Maybe we should renamed Tutorial to Slice Tutorial and then have a second Protobuf Tutorial category like in my example below?

Thoughts @externl @bernardnormier

Slice Tutorial
|-- Writing your First Server application 
|-- Writing your First Client Application
Protobuf Tutorial
|-- Writing your First Server application 
|-- Writing your First Client Application
Screenshot 2023-11-28 at 9 02 38 AM
bernardnormier commented 11 months ago

I think that the Slice tutorial should go first here. Also I think it does seem a bit cluttered and hard to parse since the titles are so similar. Maybe we should renamed Tutorial to Slice Tutorial and then have a second Protobuf Tutorial category like in my example below?

Thoughts @externl @bernardnormier

Slice Tutorial
|-- Writing your First Server application 
|-- Writing your First Client Application
Protobuf Tutorial
|-- Writing your First Server application 
|-- Writing your First Client Application

These are all IceRPC tutorials, not Slice tutorials or Protobuf tutorials.

ReeceHumphreys commented 11 months ago

I think that the Slice tutorial should go first here. Also I think it does seem a bit cluttered and hard to parse since the titles are so similar. Maybe we should renamed Tutorial to Slice Tutorial and then have a second Protobuf Tutorial category like in my example below? Thoughts @externl @bernardnormier

Slice Tutorial
|-- Writing your First Server application 
|-- Writing your First Client Application
Protobuf Tutorial
|-- Writing your First Server application 
|-- Writing your First Client Application

These are all IceRPC tutorials, not Slice tutorials or Protobuf tutorials.

Something like this then? Titles aside, I was asking more about this structure / hierarchy .

 IceRPC + Slice Tutorial
 |-- Writing your First Server application 
 |-- Writing your First Client Application
 IceRPC + Protobuf Tutorial
 |-- Writing your First Server application 
 |-- Writing your First Client Application
pepone commented 11 months ago

Let's improve things in a follow-up PR.