Improve Sidebar tree about elements HOT 5 CLOSED

Hey @lottamus, @pytlesk4, can we sync quickly on this issue? It will require some API changes and I want to check-in if you have a better idea.

In essence, projects.nodes endpoint will need to return data (a string that we can later JSON.parse). I think it makes sense to send the entire data object (even though I will be picking only one property right now - the method name) but maybe you don't think it doesn't make sense.

from elements.

maybe you don't think it doesn't make sense

The entire data object could potentially be huge. Returning that for 300+ nodes would be a lot of data. Ideally we would just create this tree data object in the analyzer then store is in another table for easy access but we need a design doc on how that should work.

For now I suggest just grabbing whatever you need and returning it with the node. https://github.com/stoplightio/api-gen3/blob/58b22e774795631c5a52a423ff21711dfbf14cf1/src/services/projects/controller.ts#L62

from elements.

Cool, makes sense!

from elements.

Leaving this to someone from Docs squad.

from elements.

Closing in favor of #67

from elements.